An e-commerce transportation and delivery application that provides MiniPay users with a new type of Web3 experience, offering ride-sharing and delivery services powered by cUSD on the Celo Blockchain.
In many parts of Africa, reliable transportation and delivery services are scarce, leading to inefficiencies and delays. Traditional payment methods can be cumbersome and insecure, limiting access to essential services. MiniRide addresses these issues by providing a seamless, secure, and efficient platform for ride-sharing and deliveries, leveraging the power of blockchain technology and cryptocurrency.
Users / Passengers
- Required to sign in with their Google account for quick onboarding utilizing Celo's Social Connect phone numbers are used for quick onboarding.
Drivers
- Required to sign with thier Google Account via Celo's Social Connect, addiniltiy require to inrole in the driver role, creating a profile in the process.`
Businesses
- Required to register through the smart contract, digital representing their business on the blockchain.
Ride share
Both drivers and passengers access the service through the Mini Ride dApp via MiniPay. Drivers must enroll in the service before participating. The user starts the process by selecting their destination on a map and then interacting with a smart contract that facilitates the payment of cUSD. The pickup and dropoff locations are entered into Google Firebase. Firebase pairs the driver and passenger that best match the ride. The driver is notified and required to confirm the request via the smart contract, which also updates the Firebase entry. Once the ride is complete, the driver confirms the completion through the smart contract. The passenger then confirms the completion of the ride, providing a rating and an optional review. The driver interacts with the contract to release the payment for the ride.
Users interact with a map view (Google Maps) displaying businesses that accept cUSD and are registered with MiniRide. Once selected, users can view the online store and the products they sell. The delivery process starts when users purchase a product via a smart contract. The store location and proof of purchase output from the smart contract are entered into Google Firebase. Firebase pairs a driver with the delivery. Once accepted, users can get live location updates of their delivery through the Realtime Database. The driver confirms the completion of the delivery via the smart contract, notifying the user in the process. The user then confirms the completion of the delivery, providing a rating and an optional review. Additionally, users can review the item they purchased from the business, with all records stored on the blockchain. The driver interacts with the contract to release the payment of the delivery.
- Swift onboarding via social connect with phone number authentication.
- Flexible and supportive multisig escrow functionality.
- Immutable reviews for businesses, ensuring transparency and trust.
- Google Maps API for locations.
MiniRide consists of three integral elements: Frontend, Smart Contracts, and Firebase. Each plays a crucial role in facilitating the service.
A React-based dApp enables each role to interact with the service. The goal is to provide a quick, simple, and secure user experience. Each party has its own React page, facilitating their respective roles. Both users and drivers utilize the Google Maps API for querying services and selecting locations.
Users
- Requiring users to sign in with their Google Account via phone number provides simplicity and security.
- Users select between two services (ride, delivery)
- Ride : Users select the pickup and drop-off locations by dropping pins on a map view (Google Maps).
- Delivery : Users pick pins on a map view linked to businesses that accept cUSD cryptocurrency. The link forwards to the business's online store view, allowing users to purchase an item and get live delivery notifications.
Drivers
- Drivers view a list of incoming requests that fit their driving criteria. Drivers have the option to select and fulfill a request.
Business
- Businesses can register on the MiniRide platform, allowing users to discover items for purchase using Minipay.
MiniPay Flow Diagram
- Roles
- Business.sol : Allows creation and registration of a business.
- Drivers.sol : Allows registration of a driver.
MultiSig.sol : Handles payments of cUSD between two or more parties.
OrderManagement.sol : Manages and processes request orders (rides, deliveries) and provides proof of purchases (PoP).
RatingReputationReviews.sol : On-chain management system for rating, reputation, and reviews.
TransportAndDelivery.sol : Manages user and driver interactions with requests (creation, completion, and cancellations).
Mainnet Deployed Contract
TransportAndDeliveryWithAttestation.sol : Manages user and driver interactions with requests with attestations.
Contracts UML Diagram
Authentican : Handles onboarding and logging in of users. Allows for secure entries into Firebase.
Firebase : Storage of user requests, securely linked to user accounts.
Realtime : Updates requests for real-time status updates and location tracking.
Web2/Web3 Flow Diagram
- Rewards and inceatives for drivers and users
- Migrate to EAS
Refer to hardhat readme
Refer to react-app readme
Distributed under the Apache License. See LICENSE.txt for more information.