Documentation Index Fetch the complete documentation index at: https://docs.vibesflow.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 : 0x5ac3193b6DD7B520D63EbE65b59f97a2dF4ee686Standard : ERC-721 (NFT)Token Symbol : VIBE-TIXFeatures : Centralized ticketing, revenue distribution, ticket validationCore 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 VibeFactorycreator: Address that will receive ticket sale revenueticketsAmount: Total number of tickets available (must be > 0)ticketPrice: Price per ticket in weidistance: 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 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
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 );
// 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/perksPPM 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
