How skygod07/smareet works
SMAREET is an Algorand event-ticketing dApp, with wallet-connected frontend features, a FastAPI ticketing backend, and on-chain ticket contracts. The main ticket workflow creates an event, requests a mint through the backend, calls the ticketing contract to create an ASA, and records ticket data; a background subscriber syncs chain state. The README also documents general-purpose Algorand features (NFT minting, ASA creation, opt-in, transfers, counter, and bank). Some subsystem links are based on README documentation because their implementation was not sampled.
Main entry points: Home.tsx Feature hub · routes.py Ticket routes · main.py FastAPI entry · algorand_service.py Chain service
Components 24
Frontend dApp
- App shell
projects/frontend/src/App.tsx - Feature hub
projects/frontend/src/Home.tsx - NFT minting
projects/frontend/src/components/MintNFT.tsx - Create ASA
projects/frontend/src/components/CreateASA.tsx - Asset opt-in
projects/frontend/src/components/AssetOptIn.tsx - Send ALGO
projects/frontend/src/components/SendAlgo.tsx - My tickets
projects/frontend/src/components/MyTickets.tsx - Counter UI
projects/frontend/src/components/AppCalls.tsx - Bank UI
projects/frontend/src/components/Bank.tsx - Ticket API client
projects/frontend/src/services/api.ts
Ticketing backend
- FastAPI entry
backend/app/main.py - Ticket routes
backend/app/routes.py - Chain service
backend/app/algorand_service.py - Chain subscriber
backend/app/subscriber.py - Ticket data models
backend/app/models.py - SQLite database
backend/app/database.py
Algorand contracts
- Ticketing client
projects/contracts/smart_contracts/artifacts/ticketing/event_ticketing_client.py - Ticketing contract
projects/contracts/smart_contracts/ticketing/contract.py - Counter contract
projects/contracts/smart_contracts/counter/contract.py - Bank contract
projects/contracts/smart_contracts/bank/contract.py
External services
- Media pinning
projects/frontend/src/utils/pinata.ts - Algorand network
- Algorand wallets
Other components
- Attendee
Connections 33
- Attendee → App shell: uses
- App shell → Feature hub: renders
projects/frontend/src/App.tsx - Feature hub → NFT minting: offers
projects/frontend/src/Home.tsx - Feature hub → Create ASA: offers
projects/frontend/src/Home.tsx - Feature hub → Asset opt-in: offers
projects/frontend/src/Home.tsx - Feature hub → Send ALGO: offers
projects/frontend/src/Home.tsx - Feature hub → My tickets: offers
projects/frontend/src/Home.tsx - Feature hub → Counter UI: offers
projects/frontend/src/Home.tsx - Feature hub → Bank UI: offers
projects/frontend/src/Home.tsx - NFT minting → Media pinning: pins media
projects/frontend/src/components/MintNFT.tsx - NFT minting → Algorand network: mints NFT
- Create ASA → Algorand network: creates asset
- Asset opt-in → Algorand network: opts in
- Send ALGO → Algorand network: sends payment
- My tickets → Ticket API client: loads tickets
projects/frontend/src/components/MyTickets.tsx - Ticket API client → Ticket routes: requests API
- Counter UI → Counter contract: calls
- Bank UI → Bank contract: calls
projects/frontend/src/components/Bank.tsx - Bank UI → Algorand network: reads history
projects/frontend/src/components/Bank.tsx - App shell → Algorand wallets: provides wallet
projects/frontend/src/App.tsx - FastAPI entry → Ticket routes: mounts
backend/app/main.py - FastAPI entry → SQLite database: initializes
backend/app/main.py - FastAPI entry → Chain service: initializes
backend/app/main.py - FastAPI entry → Chain subscriber: starts
backend/app/main.py - Ticket routes → Chain service: mints on-chain
backend/app/routes.py - Ticket routes → SQLite database: reads and writes
backend/app/routes.py - Ticket routes → Ticket data models: uses records
backend/app/routes.py - Chain service → Ticketing client: calls
backend/app/algorand_service.py - Chain service → Algorand network: submits transactions
backend/app/algorand_service.py - Ticketing client → Ticketing contract: invokes methods
- Ticketing contract → Algorand network: creates ticket ASA
- Chain subscriber → SQLite database: syncs chain state
backend/app/subscriber.py - Chain subscriber → Algorand network: polls indexer