VibeKiosk Contract

The VibeKiosk contract is a standalone ERC-721 NFT contract that manages ticket sales for all vibestreams. It provides a centralized ticketing system with automatic revenue distribution.

Contract Overview

Address: 0x5ac3193b6DD7B520D63EbE65b59f97a2dF4ee686
Standard: ERC-721 (NFT)
Token Symbol: VIBE-TIX
Features: Centralized ticketing, revenue distribution, ticket validation

Core Data Structures

Ticket Configuration

Each vibestream registered with VibeKiosk has an associated configuration:

struct TicketConfig {
    uint256 vibeId;        // Vibestream identifier
    address creator;       // Vibestream creator
    uint256 ticketsAmount; // Total ticket supply
    uint256 ticketPrice;   // Price per ticket (wei)
    uint256 distance;      // Geographic constraint
    uint256 ticketsSold;   // Number of tickets sold
    bool isActive;         // Registration status
}

Ticket Data

Each minted ticket contains detailed information:

struct TicketData {
    uint256 vibeId;           // Associated vibestream
    uint256 ticketId;         // Unique ticket identifier
    address originalOwner;    // Original purchaser
    uint256 purchasePrice;    // Price paid (wei)
    uint256 purchaseTimestamp; // Purchase time
    uint256 ticketNumber;     // Sequential number within vibestream
}

Core Functions

Vibestream Registration

Only VibeFactory can register vibestreams for ticket sales:

function registerVibestream(
    uint256 vibeId,
    address creator,
    uint256 ticketsAmount,
    uint256 ticketPrice,
    uint256 distance
) external onlyVibeFactory

Parameters:

vibeId: Unique vibestream identifier from VibeFactory
creator: Address that will receive ticket sale revenue
ticketsAmount: Total number of tickets available (must be > 0)
ticketPrice: Price per ticket in wei
distance: Geographic constraint in meters

Process:

Validates input parameters
Ensures vibestream is not already registered
Creates ticket configuration
Emits VibestreamRegistered event

Ticket Purchase

Users can purchase tickets for registered vibestreams:

function purchaseTicket(uint256 vibeId) 
    external payable nonReentrant returns (uint256 ticketId)

Requirements:

Vibestream must be registered and active
Must send sufficient tMETIS (≥ ticket price)
Tickets must still be available

Process:

Validates vibestream and payment
Mints ERC-721 ticket NFT
Records ticket data and ownership
Updates user and vibestream mappings
Distributes revenue (80% creator, 20% treasury)
Refunds excess payment
Returns unique ticket ID

Revenue Distribution

Automatic 80/20 split on all ticket sales:

// 80% to creator, 20% to treasury
uint256 creatorShare = (ticketPrice * 80) / 100;
uint256 treasuryShare = ticketPrice - creatorShare;

if (creatorShare > 0) {
    payable(creator).transfer(creatorShare);
}
if (treasuryShare > 0) {
    payable(treasuryReceiver).transfer(treasuryShare);
}

Ticket Management

Ticket Information Retrieval

function getTicketInfo(uint256 ticketId) external view returns (
    uint256 vibeId,
    address owner,
    address originalOwner,
    uint256 purchasePrice,
    uint256 purchaseTimestamp,
    string memory name,
    uint256 distance,
    string memory metadataURI,
    uint256 ticketNumber,
    uint256 totalTickets
)

Returns comprehensive ticket information including ownership history and vibestream details.

User Ticket Queries

// Get all tickets owned by a user
function getUserTickets(address user) external view returns (uint256[] memory)

// Get user's tickets for a specific vibestream
function getUserTicketsForVibe(address user, uint256 vibeId) 
    external view returns (uint256[] memory)

// Check if user has any ticket for a vibestream
function hasTicketForVibestream(address user, uint256 vibeId) 
    external view returns (bool)

Vibestream Queries

// Get all tickets for a vibestream
function getVibeTickets(uint256 vibeId) external view returns (uint256[] memory)

// Get vibestream ticket configuration
function getVibeConfig(uint256 vibeId) external view returns (TicketConfig memory)

// Get sales information
function getSalesInfo(uint256 vibeId) external view returns (
    uint256 totalTickets,
    uint256 soldTickets,
    uint256 remainingTickets,
    uint256 price,
    uint256 distance
)

Ticket Validation

Availability Check

function isAvailable(uint256 vibeId) external view returns (bool)

Checks if tickets are still available for purchase.

Ownership Validation

Standard ERC-721 functions for ownership verification:

function ownerOf(uint256 ticketId) external view returns (address)
function balanceOf(address owner) external view returns (uint256)

Events

Registration Event

event VibestreamRegistered(
    uint256 indexed vibeId,
    address indexed creator,
    uint256 ticketsAmount,
    uint256 ticketPrice,
    uint256 distance
);

Purchase Event

event TicketMinted(
    uint256 indexed vibeId,
    uint256 indexed ticketId,
    address indexed buyer,
    uint256 price
);

Security Features

Reentrancy Protection

All payable functions use OpenZeppelin’s nonReentrant modifier:

function purchaseTicket(uint256 vibeId) 
    external payable nonReentrant returns (uint256 ticketId)

Access Control

Only VibeFactory can register vibestreams
Only contract owner can update configuration
Standard ERC-721 transfer controls apply to tickets

Input Validation

Comprehensive validation on all operations:

require(creator != address(0), "Invalid creator address");
require(ticketsAmount > 0, "Must have at least 1 ticket");
require(!vibeConfigs[vibeId].isActive, "Vibestream already registered");
require(msg.value >= config.ticketPrice, "Insufficient payment");

Administrative Functions

Configuration Updates

function updateVibeFactory(address _vibeFactory) external onlyOwner
function updateTreasuryReceiver(address _treasuryReceiver) external onlyOwner

Emergency Functions

function emergencyWithdraw() external onlyOwner

Allows owner to withdraw contract balance in emergency situations.

Token URI Generation

Tickets have automatically generated token URIs:

string memory tokenUri = string(abi.encodePacked(
    "vibestream-", 
    _toString(vibeId), 
    "-ticket-", 
    _toString(ticketId)
));

Usage Examples

Purchasing a Ticket

// Purchase ticket for vibestream #123 (assuming 0.1 tMETIS price)
uint256 ticketId = vibeKiosk.purchaseTicket{value: 0.1 ether}(123);

Checking Ticket Ownership

// Check if user owns tickets for vibestream #123
bool hasTicket = vibeKiosk.hasTicketForVibestream(userAddress, 123);

// Get all user's tickets for vibestream #123
uint256[] memory userTickets = vibeKiosk.getUserTicketsForVibe(userAddress, 123);

Getting Sales Information

// Get sales info for vibestream #123
(
    uint256 totalTickets,
    uint256 soldTickets,
    uint256 remainingTickets,
    uint256 price,
    uint256 distance
) = vibeKiosk.getSalesInfo(123);

Integration with VibeFactory

VibeKiosk integrates with VibeFactory through automatic registration:

// In VibeFactory.createVibestream()
if (ticketsAmount > 0 && vibeKiosk != address(0)) {
    IVibeKiosk(vibeKiosk).registerVibestream(
        vibeId, 
        msg.sender, 
        ticketsAmount, 
        ticketPrice, 
        distance
    );
}

Dual Monetization

Vibestreams can simultaneously support both ticket sales and real-time streaming:

Ticket Sales: One-time purchase for access/perks
PPM Streaming: Ongoing payments for active participation

This allows creators to monetize both access and engagement separately.

Next Steps

Subscriptions Contract

Learn about Vibe Market subscriptions

Contract Flows

See integration patterns

Overview

Core Contracts

Integration

​VibeKiosk Contract

​Contract Overview

​Core Data Structures

​Ticket Configuration

​Ticket Data

​Core Functions

​Vibestream Registration

​Ticket Purchase

​Revenue Distribution

​Ticket Management

​Ticket Information Retrieval

​User Ticket Queries

​Vibestream Queries

​Ticket Validation

​Availability Check

​Ownership Validation

​Events

​Registration Event

​Purchase Event

​Security Features

​Reentrancy Protection

​Access Control

​Input Validation

​Administrative Functions

​Configuration Updates

​Emergency Functions

​Token URI Generation

​Usage Examples

​Purchasing a Ticket

​Checking Ticket Ownership

​Getting Sales Information

​Integration with VibeFactory

​Dual Monetization

​Next Steps