Skip to content

A token bound implementation of event management and ticketing platform.

Notifications You must be signed in to change notification settings

crowdpass-live/tokenbound_impl

Repository files navigation

CrowdPass

Decentralized Event Ticketing on Stellar

Secure, transparent, and fraud-proof event management powered by blockchain technology

Overview

CrowdPass is a decentralized event ticketing platform built on the Stellar blockchain that revolutionizes how event organizers create and manage tickets while providing attendees with unprecedented security, transparency, and control over their ticket purchases.

By leveraging Stellar's fast, low-cost transactions and smart contract capabilities (Soroban), CrowdPass eliminates ticket fraud, ensures transparent fund management, and provides automatic refunds for canceled events—all while maintaining a seamless user experience.

Problem & Solution

Current Industry Challenges

The event ticketing industry suffers from critical inefficiencies that affect both organizers and attendees:

For Event Organizers

  • Ticket Duplication: Malicious actors can forge or duplicate tickets, undermining event security and revenue
  • Revenue Loss: Lack of transparent tracking leads to unaccountable funds and potential financial discrepancies
  • Fraud Prevention: Limited tools to verify ticket authenticity at scale

For Event Attendees

  • Counterfeit Tickets: Risk of purchasing fake tickets from unauthorized resellers
  • Refund Uncertainty: Difficulty obtaining refunds for canceled or rescheduled events
  • No Ownership Rights: Inability to securely transfer or resell tickets without risk

The CrowdPass Solution

CrowdPass addresses these challenges through blockchain-native ticketing:

Immutable Ticket NFTs - Each ticket is a unique digital asset on Stellar, making duplication impossible

Transparent Escrow - Smart contracts hold funds securely until event completion, protecting both parties

Automatic Refunds - Canceled events trigger instant refund distribution to ticket holders

Secure Secondary Market - Built-in resale functionality with verified provenance

Token-Bound Accounts - Tickets can hold assets, badges, and privileges that transfer with ownership

Features

Core Functionality

  • 🎫 Event Creation & Management

    • Create events with customizable parameters (date, venue, capacity)
    • Set dynamic pricing tiers and ticket types
    • Monitor real-time sales analytics
  • 🔒 Secure Escrow System

    • Funds locked in smart contracts until event completion
    • Protection against organizer misconduct
    • Automatic settlement post-event
  • 💰 Automated Refund Processing

    • Instant refunds for canceled events
    • No manual claims process required
    • Funds returned directly to ticket holders
  • 🔄 Verified Ticket Resale

    • Peer-to-peer ticket transfers on-chain
    • Organizer-set resale rules and royalties
    • Complete ownership history tracking
  • 🏅 Token-Bound Ticket Accounts

    • Tickets as smart wallets holding digital collectibles
    • POAP badges automatically sent to ticket holders
    • Exclusive perks and benefits tied to ticket ownership

Technical Advantages

  • ⚡ Fast Transactions: Stellar's 3-5 second settlement times
  • 💵 Low Fees: Minimal transaction costs (fractions of a cent)
  • 🌍 Global Access: Borderless payments in multiple currencies
  • 🔐 Enterprise Security: Battle-tested blockchain infrastructure
  • 📱 User-Friendly: Intuitive interfaces hiding blockchain complexity

Architecture

Smart Contract Design

CrowdPass utilizes Stellar's Soroban smart contracts to implement:

┌─────────────────────────────────────────────────────────┐
│                   CrowdPass Platform                    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────┐ │
│  │    Event     │───▶│   Ticket     │───▶│  Escrow  │ │
│  │   Manager    │    │     NFT      │    │ Contract │ │
│  └──────────────┘    └──────────────┘    └──────────┘ │
│         │                    │                  │      │
│         ▼                    ▼                  ▼      │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────┐ │
│  │  Metadata    │    │ Token-Bound  │    │  Refund  │ │
│  │   Storage    │    │   Accounts   │    │  Logic   │ │
│  └──────────────┘    └──────────────┘    └──────────┘ │
│                                                         │
└─────────────────────────────────────────────────────────┘
                         │
                         ▼
              ┌──────────────────┐
              │ Stellar Blockchain│
              └──────────────────┘

Key Components

  1. Event Registry: On-chain record of all events and their parameters
  2. NFT Tickets: Soroban-based NFTs representing unique ticket ownership
  3. Escrow Contract: Holds funds with conditional release logic
  4. Token-Bound Implementation: Tickets function as autonomous accounts
  5. Refund Mechanism: Automated distribution based on event status

Smart Contract Functions

Organizer Functions

  • create_event(params) - Initialize a new event with ticketing parameters
  • cancel_event(event_id) - Cancel event and trigger refund process
  • reschedule_event(event_id, new_date) - Update event timing
  • create_ticket_tier(event_id, tier_params) - Define ticket types and pricing
  • withdraw_funds(event_id) - Claim revenue after event completion

Attendee Functions

  • purchase_ticket(event_id, tier) - Buy tickets with XLM or supported assets
  • resale_ticket(ticket_id, price) - List ticket for secondary sale
  • claim_refund(ticket_id) - Manually trigger refund for canceled events
  • transfer_ticket(ticket_id, recipient) - Gift or transfer ownership
  • view_ticket_benefits(ticket_id) - See associated POAPs and perks

Getting Started

Prerequisites

Installation

# Clone the repository
git clone https://github.com/your-org/crowdpass.git
cd crowdpass

# Install dependencies
npm install

# Build smart contracts
cd contracts
soroban contract build

# Deploy to testnet
soroban contract deploy \
  --wasm target/wasm32-unknown-unknown/release/crowdpass.wasm \
  --network testnet

Quick Start

# Run local development server
npm run dev

# Run tests
npm test

# Deploy to production
npm run deploy

Use Cases

🎵 Concert & Festival Ticketing

Eliminate scalping with blockchain-verified tickets and automated royalty payments to artists.

🎭 Theater & Performing Arts

Season pass holders receive exclusive NFT badges unlocking backstage content and priority booking.

🏟️ Sporting Events

Teams issue commemorative POAPs to ticket holders, building verifiable fan communities.

🎓 Conferences & Workshops

Automatic credential NFTs for attendees, serving as proof of participation for professional development.

🎪 Community Events

Small organizers access enterprise-grade ticketing without upfront costs or platform fees.

Security Considerations

  • Audited Contracts: All smart contracts undergo third-party security audits
  • Multi-Signature Controls: Critical functions require multiple approvals
  • Rate Limiting: Protection against spam and malicious attacks
  • Escrow Guarantees: Mathematical proof of fund availability for refunds
  • Privacy Options: Optional anonymity for ticket purchases

Contributing

We welcome contributions from the Stellar community! See CONTRIBUTING.md for guidelines.

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see LICENSE file for details.

Support

Acknowledgments

Built with ❤️ for the Stellar ecosystem

  • Stellar Development Foundation for blockchain infrastructure
  • Soroban team for smart contract platform
  • Open-source contributors and early adopters

Reimagining event ticketing for the decentralized era

About

A token bound implementation of event management and ticketing platform.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •