How team-somehow/ticket works
Project type and purpose
• FanBase is a full-stack, blockchain-enabled ticketing platform combining:
• Multiple React-based frontends (fan-facing “client/frontend” and organizer “organizer”)
• Serverless backends (Firebase Functions in Python and Node)
• On-chain smart contracts (StarkNet/Cairo & ERC-2981 EVM)
• Off-chain attestation & proof services
• External integrations (Spotify OAuth, Worldcoin/Anonaadhar, Coinbase)
File structure
• Top-level workspaces:
• attestation/ — Node TS service using True Network schemas & proofs
• client/ & organizer/ & frontend/ — Three parallel React+Vite/TypeScript UIs
• client/functions & functions-zkfetch & functions/ — Serverless Python/JS for OAuth, storage, ZK-fetch
• starknet/ — Cairo contracts, deployment scripts, Docker compose
• web3-interactions/ — TypeScript library for on-chain calls (Ethers/wagmi)
• firebase.json & .firebaserc — Firebase hosting & functions config
• docs/ — VitePress site describing APIs & guides
README for additional insight
• Core features:
• Fan scoring via Spotify data → priority queue
• ERC-2981 royalties & capped resale prices
• NFT-based non-resalable tickets
• Loyalty discounts & emerging artist perks
• Multi-network deployment (Sepolia, BSC, StarkNet)
Components
• UI Tier
• Fan Web App (React/Vite)
• Organizer Web App (React/Vite)
• API & Business Logic
• Firebase Functions (Python/Node)
• ZK-fetch Functions (JS)
• Attestation Service (Node/True Network)
• Blockchain Tier
• StarkNet Contracts (Cairo)
• EVM Contracts (ERC-2981)
• Web3-interactions library
• Data Indexing & Storage
• Firebase Firestore or Realtime Database
• External Services
• Spotify API (OAuth)
• Worldcoin/Anonaadhar
• Coinbase/ETH wallet providers
• Frontends ←→ Firebase Functions (user auth, fan‐score retrieval)
• Frontends → Web3-interactions → Smart Contracts (apply/buy/sell tickets)
• Firebase Functions → Attestation Service → True Network proofs
• Serverless Functions ↔ Spotify API (OAuth & listening data)
• Frontends ↔ Wallet providers (MetaMask/Coinbase)
c. Architectural patterns & principles:
• Microfrontend: parallel consumer & organizer apps
• Serverless microservices: Firebase Functions & ZK-fetch
• Layered architecture: UI → API → Blockchain → Storage
• Security by design: OAuth & attestations for data integrity
d. Key technologies & frameworks:
• React, TypeScript, Vite, Tailwind CSS
• Firebase (hosting, functions, Firestore)
• Node.js & Python for serverless code
• Cairo/Scarb for StarkNet contracts
• Ethers.js/wagmi for Ethereum interactions
• GraphQL & The Graph for indexing
Detail is critical
• Every major component—even if internal libraries (web3-interactions)