Welcome to Tranzit, a decentralized application that revolutionises contactless payments. Leveraging the power of the Celo blockchain, this app ensures secure, fast, and efficient transactions between commuters and drivers using QR code technology.

• Blockchain: Built on Celo to ensure secure, decentralized payments.

• Smart Contracts: Deployed on Celo Mainnet to handle transactions, incentives, and user interactions.

• Incentives: Users are rewarded with 0.2 cUSD after interacting with 2 unique users.

• QR Code Payments: Fast and convenient transactions using QR code technology.

• Fonbnk API Integration: Enables cUsd-to-Airtime conversion for seamless fund access.

• Wallet Compatibility: Now supports embeded wallets from privy and third web for easy user onboarding.

• Progressive Web App (PWA): Works seamlessly across web and mobile, even offline (Full offline mode still in the works).

• The Graph: Fetch and display transaction and incentive data efficiently.

flowchart LR
    A[Celo Blockchain] --> B[Tranzit DApp Thirdweb]
    B -->|Provides social login & <br/> embedded wallets| C[Commuters & Drivers]
    B -->|Handles gas via relayer| A
    A -->|Used for cUSD| D[Smart Contract]
    D -->|Tracks<br/> unique interactions| E[User Data]
    D -->|Transfers 1% fee| F[Incentive Pool]
    D -->|Awards| G[0.2 cUSD Incentive]
    H[Owner/Operator] -->|Manages config| D

Tranzit facilitates contactless payments while incentivizing user interactions within the ecosystem.

• Drivers and Commuters: Conduct transactions via QR codes.
• Smart Contract: Handles payments, tracks interactions, and awards incentives.
• Incentive Pool: Funded by a 1% transaction fee to reward users.
• Celo Blockchain & cUSD: Provides a decentralized platform and stable currency.
• Fonbnk API: Allows users to convert cUSD into Airtime and offers an easy on and off ramp solution at a low cost.

flowchart TB
    A((Start)) --> B{Social Login}
    B -->|User logs in| C[Generate/Access Embedded Wallet]
    C --> D[Driver sets price and generates QR code]
    D --> E[Commuter scans QR code]
    E --> F[Payment initiated through<br/>Thirdweb Relayer]
    F --> G[Smart Contract processes payment]
    G -->|Transfer cUSD minus tax| H[Driver's Wallet]
    G -->|Transfer 1% tax| I[Contract Balance/Incentive Pool]
    G --> J[Update unique user interactions]
    J --> K[Check for incentive eligibility]
    K -->|If eligible| L[Award 0.2 cUSD incentive]
    K -->|If not eligible| M((End))
    L --> M((End))

Understanding the step-by-step process from initiating a payment to receiving incentives.

1. The driver sets the fare and generates a QR code.
2. The commuter scans the QR code to initiate payment.
3. Smart Contract processes the payment:
   • Transfers cUSD (minus 1% fee) to the driver's wallet.
   • Allocates a 1% fee to the incentive pool.
4. Smart Contract updates user interactions and checks for incentive eligibility.
5. Incentives are awarded if eligibility criteria are met.
6. Users can fund their wallets via Fonbnk’s airtime conversion.

flowchart LR
    A([Social Login<br/>Provider]) -->|Authenticates user| B([Thirdweb/Embedded Wallet])
    B -->|Scans QR wallet ID + amount| C([Commuter UI])
    C -->|Initiates payment request| D([Relayer<br/>via Thirdweb])
    D -->|Submits transaction| E([Smart Contract])
    E -->|Verifies cUSD balance<br/> & processes tax| F([Driver's Wallet])
    E -->|Transfers tax<br/> to Incentive Pool| G([Incentive Pool])
    E -->|Updates user data| H([User Data<br/>Balances & Interactions])
    E -->|Checks eligibility| I([Incentive Eligibility])
    I -->|If eligible, awards incentives| B

A detailed look at how data moves through the system during a transaction.

1. The commuter scans the QR code to obtain payment info.
2. Payment details are sent to the Smart Contract.
3. Smart Contract verifies balances, processes payments, and updates user data.
4. Incentive Pool collects transaction fees and funds incentives.
5. Users receive incentives after qualifying interactions.

• Contract Address: 0x7f8EFB57b228798d2d3ec3339cD0a155EB3B0f96 (CELO MAINNET)
• cUSD Token Address: 0x765de816845861e75a25fca122bb6898b8b1282a

• Driver Interface: Generates QR codes for fare amounts.
• Commuter Interface: Scans QR codes to complete transactions.
• Incentive System: Users receive incentives after multiple interactions.
• GraphQL Integration: Retrieve and display payment and incentive data.
• Fonbnk Integration: Converts airtime to cUSD for easier onboarding.
• Embeded Wallet Support: Works with Privy and thirdweb embeded wallets.
• Progressive Web App: Ensures UI accessibility even when offline.

• Gasless Transactions: Enabling meta-transactions for frictionless payments.
• Privy Authentication: Enables social login with emails.
• Khule (AI to help users learn / onboard and resolve any issues users might encounter while paying)
• **Better progress reporting on transaction loading time.

• New Pitch Deck 📊
• Demo Video 🎥
• [Demo Video 2] (https://drive.google.com/file/d/1QrHSdAf56FzSGLahwwXDPRJ_bdc65XMc/view?usp=sharing)

This project is licensed under the MIT License.