How mrinnnmoy/kosmos works
Kosmos is a web-based event management and ticketing product: hosts create and manage events, while attendees discover events, pass a human-verification gate, join (including escrowed payment for paid events), receive tickets, check in, and earn attendance proof when events are settled. The README documents World, Uniswap, ENS, and Privy capabilities; sampled routes show join verification, persistence, and email delivery. Contract implementations are not present in the supplied tree, so on-chain behavior is represented as an external Sepolia service. Some UI-to-route wiring is not evidenced by the excerpts.
Main entry points: schema.ts Application database · join/route.ts Join processing · [id]/route.ts Event lifecycle API · approve/route.ts Request decisions
Components 33
Event experience
- Event discovery
app/web/app/discover/page.tsx - Event details
app/web/app/discover/[event-slug]/page.tsx - Event creation
app/web/app/create/page.tsx - Event management
app/web/app/events/[id]/manage/page.tsx - Check-in scanner
app/web/components/checkin/QrScanner.tsx - Ticket QR
app/web/components/tickets/TicketQrButton.tsx
Joining and payments
- Selfie Check
app/web/components/worldid/SelfieCheckButton.tsx - Join flow
app/web/components/worldid/EventJoin.tsx - Join processing
app/web/app/api/join/route.ts - Request decisions
app/web/app/api/join/[id]/approve/route.ts - Join cancellation
app/web/app/api/join/[id]/cancel/route.ts - Swap payment UI
app/web/components/join/UniswapPayButton.tsx - Swap quote API
app/web/app/api/swap-quote/route.ts - Swap build API
app/web/app/api/swap-build/route.ts - Uniswap client
app/web/lib/uniswap/client.ts
Identity and profiles
- Privy authentication
app/web/app/signin/page.tsx - Token verification
app/web/lib/auth/verify-privy-token.ts - Subname availability
app/web/app/api/ens/check-availability/route.ts - Subname registration
app/web/lib/ens/register-subname.ts - ENS registration API
app/web/app/api/ens/register/route.ts
Application services
- Application database
app/web/lib/db/schema.ts - World proof verifier
app/web/lib/worldid/verify.ts - Email notifications
app/web/lib/email/notifications.tsx - Check-in API
app/web/app/api/checkin/[ticketId]/route.ts - Event lifecycle API
app/web/app/api/events/[id]/route.ts - Shared contract ABIs
packages/shared/src/abi/EventEscrow.ts
Other components
- Attendee
- Event host
- Sepolia contracts
- World verification service
- Uniswap Trading API
- ENSv2 contracts
- Privy identity service
Connections 37
- Attendee → Event discovery: browses
README.md - Attendee → Event details: views
README.md - Event host → Event creation: creates
README.md - Event host → Event management: manages
README.md - Attendee → Privy authentication: signs in
README.md - Privy authentication → Privy identity service: authenticates
README.md - Join flow → Selfie Check: requests verification
README.md - Selfie Check → World verification service: obtains proof
README.md - Join processing → Token verification: verifies token
app/web/app/api/join/route.ts - Join processing → World proof verifier: verifies proof
app/web/app/api/join/route.ts - Join processing → Application database: reads and writes
app/web/app/api/join/route.ts - Join processing → Email notifications: sends ticket email
app/web/app/api/join/route.ts - Join flow → Join processing: submits request
- Swap payment UI → Swap quote API: requests quote
README.md - Swap payment UI → Swap build API: requests swap
README.md - Swap quote API → Uniswap client: uses
README.md - Swap build API → Uniswap client: uses
README.md - Uniswap client → Uniswap Trading API: quotes and builds
README.md - Swap payment UI → Sepolia contracts: deposits ETH
README.md - Request decisions → Application database: updates request
app/web/app/api/join/[id]/approve/route.ts - Request decisions → Email notifications: sends ticket email
app/web/app/api/join/[id]/approve/route.ts - Request decisions → Sepolia contracts: checks escrow state
app/web/app/api/join/[id]/approve/route.ts - Join cancellation → Application database: updates request
app/web/app/api/join/[id]/cancel/route.ts - Join cancellation → Sepolia contracts: checks refund
app/web/app/api/join/[id]/cancel/route.ts - Event host → Check-in scanner: checks in attendees
README.md - Check-in scanner → Check-in API: submits ticket
- Check-in API → Application database: updates attendance
- Event host → Event lifecycle API: ends event
README.md - Event lifecycle API → Application database: updates lifecycle
app/web/app/api/events/[id]/route.ts - Event lifecycle API → Sepolia contracts: checks settlement
app/web/app/api/events/[id]/route.ts - Event lifecycle API → Shared contract ABIs: decodes escrow
app/web/app/api/events/[id]/route.ts - Attendee → Ticket QR: presents ticket
README.md - Subname availability → Application database: checks name
app/web/app/api/ens/check-availability/route.ts - Subname availability → ENSv2 contracts: checks availability
app/web/app/api/ens/check-availability/route.ts - ENS registration API → Subname registration: registers subname
README.md - Subname registration → ENSv2 contracts: registers identity
README.md - ENS registration API → Application database: stores profile