npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@thesellouts/sellout-protocol

v0.1.4

Published

sold out shows.

Downloads

4

Readme

Overview

The Sellout Protocol is a decentralized platform designed to streamline the creation, ticketing, and management of shows, leveraging blockchain technology to ensure transparency, security, and efficiency. This document outlines the protocol's architecture, contract interactions, and the lifecycle of a show from proposal to payout.

Contract Architecture

The Sellout Protocol comprises several smart contracts that interact with each other to facilitate the creation and management of shows:

  • ReferralModule: Manages referral credits and permissions for artists, organizers, and venues.
  • ArtistRegistry: Registers artists and manages their information.
  • OrganizerRegistry: Registers organizers and manages their information.
  • VenueRegistry: Registers venues and manages their information.
  • Show: Manages individual shows, including proposals, ticketing, and payouts.
  • Ticket: Handles ticket issuance, transfers, and redemptions for shows.
  • Venue: Manages venue-specific information and booking for shows.

Contract Overview

+----------------+     +-------------------+     +------------------+
|                |     |                   |     |                  |
| ReferralModule |<----+ ArtistRegistry   |<----+                  |
|                |     |                   |     |                  |
+--------^-------+     +-------------------+     |                  |
         |                                       |                  |
         |                                       |    Show          |
+--------+-------+     +-------------------+     |                  |
|                |     |                   |     |                  |
| VenueRegistry  |<----+ OrganizerRegistry |<----+                  |
|                |     |                   |     +------------------+
+----------------+     +-------------------+                |
                                                          +--v---------+
                                                          |            |
                                                          |  Ticket    |
                                                          |            |
                                                          +--^---------+
                                                             |
                       +-------------------+                 |
                       |                   |<----------------+
                       |     Venue         |
                       |                   |
                       +-------------------+

Sellout Protocol: Show Lifecycle and Financial Dynamics

The Sellout Protocol reimagines the live event booking and management process, prioritizing transparency, artist and organizer empowerment, and dynamic audience engagement. This section outlines the granular steps involved in the lifecycle of a show, with a special focus on financial arrangements and automated payouts.

1. Show Proposal

An organizer proposes a show by calling the proposeShow function in the Show contract. Key details include:

  • Artists: Line-up for the show.
  • Ticket Price Structure: Minimum and maximum ticket prices.
  • Payout Splits: Predetermined splits for the organizer, artists, and venue.
  • Sellout Threshold: A defined percentage of total capacity, triggering venue bidding.
function proposeShow(
    string memory name,
    string memory description,
    address[] memory artists,
    VenueTypes.Coordinates memory coordinates,
    uint256 radius,
    uint8 sellOutThreshold,
    uint256 totalCapacity,
    ShowTypes.TicketPrice memory ticketPrice,
    uint256[] memory split
) external returns (bytes32 showId);

2. Ticket Sales and Refunds

Tickets are sold through the Ticket contract. Until the sellout threshold is reached, ticket holders can refund their tickets, ensuring a dynamic engagement with the show's demand.

3. Reaching the Sellout Threshold

Once ticket sales hit the sellout threshold:

  • The show's demand has been proven, increasing its market value.
  • Venues start bidding or offering bribes to host the show, leveraging the Venue contract.

4. Financial Arrangements and Venue Selection

The organizer, in collaboration with artists, selects the venue offering the best deal, based on:

  • Financial Offers: Higher payouts or bribes from venues.
  • Facilities and Perks: Quality of venue services and additional benefits.

5. Automated Payouts Post-Show

After the show, the Show contract automatically distributes funds according to the pre-set splits:

// Example of payout function that would be called after the show 
function completeShow(bytes32 showId) external;
  • Protocol Fee: A small percentage is allocated to the Sellout Protocol as a platform fee.
  • Payouts: The remaining funds are split between the organizer, artists, and venue as previously agreed.

Benefits of the Sellout Protocol

  • Empowerment: Artists and organizers have more control and bargaining power.
  • Transparency: Financial arrangements are transparent and enforced through smart contracts.
  • Flexibility: Ticket refund options up until the sellout threshold maintain audience engagement.
  • Automation: Payouts are automatically executed, reducing manual processing and errors.