Feature Report

BESSE Platform Features Report

Platform: Blockchain Enabled System for Sustainable Economy
Date: January 26, 2026
Version: 1.0

Executive Summary

BESSE is a comprehensive blockchain-based platform for managing waste and recycling materials through auctions, asset tracking, and logistics. The platform consists of a web application and a mobile application (React Native/Expo), both integrated with Firebase backend services and Ethereum smart contracts.

Table of Contents

  1. Platform Overview
  2. Web Application Features
  3. Mobile Application Features
  4. Shared Features
  5. Role-Based Access Control
  6. Blockchain & Smart Contracts
  7. Backend Services

Platform Overview

Technology Stack

  • Web: React.js with Redux, React Router, Vite
  • Mobile: React Native (Expo) with TypeScript
  • Backend: Firebase (Firestore, Cloud Functions, Storage, Authentication)
  • Blockchain: Ethereum (Sepolia testnet), Smart Contracts (Solidity)
  • Authentication: Privy (Web3 wallet authentication)
  • Maps & Location: Google Maps API, React Native Maps

Web Application Features

1. Authentication & User Management

  • Wallet-based Authentication
    • Privy integration for Web3 wallet connection
    • Google OAuth support
    • Nonce-based signature authentication
    • Firebase authentication integration
  • User Registration
    • Role-based registration (Municipality, Hauler, MRF, Transportation, Broker, Remanufacturer/Mill, Landfill)
    • Profile creation with user information
    • Avatar/profile picture upload
  • User Profile
    • Profile picture management
    • User information display
    • Wallet address display
    • ETH balance display

2. Asset Management

  • Asset Creation
    • Create digital assets representing recyclable materials
    • Material type selection (WARM-compliant)
    • Quantity input
    • Title and description
    • Image upload (multiple images)
    • NFT minting on blockchain
  • Asset Listing
    • View all owned assets
    • Filter assets by status (available for auction, in auction, sold)
    • Asset details view
  • Material Types
    • WARM (Waste and Recycling Management) integration
    • Support for various recyclable materials
    • Material type restrictions based on user role

3. Auction System

  • Auction Creation
    • Create English auctions (ascending bid)
    • Create Dutch auctions (descending price)
    • Create Fixed Price sales
    • Set auction parameters:
      • Starting price/reserve price
      • Duration/timing
      • Start date and time
    • Role-based auction creation permissions
  • Auction Browsing
    • View all active auctions
    • Filter auctions by material type
    • Grid and list view toggle
    • Live auction indicators
    • Auction cards with key information
  • Auction Details
    • Detailed auction information
    • Asset details and images
    • Seller information
    • Current bid/highest bid display
    • Timer countdown
    • Bid history
    • Place bid functionality
    • Auction status tracking
  • Bidding
    • Place bids on auctions
    • View bid history
    • Bid withdrawal (for outbid users)
    • Real-time bid updates
    • Role-based bidding permissions

4. Dashboard & Analytics

  • User Dashboard
    • Personal statistics overview
    • Auction performance metrics
    • Transaction history
    • Asset ownership statistics
    • Sales charts (stacked charts)
    • Period filters (day, week, month)
    • Profile picture management
  • Statistics
    • Total auctions created
    • Total bids placed
    • Assets owned
    • Unique bale types
    • Transaction counts
  • Charts & Visualizations
    • Stacked charts for sales data
    • Time period filtering
    • Multiple chart types

5. Orders & Transactions

  • Orders Management
    • View all orders/transactions
    • Filter by status
    • Transaction details
    • Order history
  • Transaction Tracking
    • View transactions user is involved in
    • Transaction status
    • Payment information

6. Scanner/QR Code

  • QR Code Scanner
    • Scan QR codes for asset tracking
    • Asset identification via QR codes

7. System Configuration (Admin Only)

  • Admin Dashboard
    • System configuration management
    • Smart contract deployment
    • Auction Factory contract deployment
    • WARM configuration management
    • Welcome ETH bonus configuration
    • System status monitoring
    • Contract deployment status

8. Legal & Compliance

  • Privacy Policy
    • Privacy policy page
  • Terms of Service
    • Terms of service page
  • Wallet Export
    • Wallet export functionality

Mobile Application Features

1. Authentication & Onboarding

  • Authentication Flow
    • Login screen
    • Registration screen
    • Onboarding flow
    • Privy integration for wallet authentication
    • Google OAuth support
  • User Profile
    • Profile management
    • Edit profile screen
    • Profile picture management

2. Home & Navigation

  • Tab Navigation
    • Home tab
    • Auctions tab
    • Shipments tab
    • Dashboard/Stats tab
    • Profile tab
  • Home Screen
    • Overview of platform activity
    • Quick access to key features
    • Notifications feed

3. Asset Management

  • Asset Listing
    • View all assets
    • Asset details view
    • Asset creation (mobile-optimized)
  • Asset Details
    • Full asset information
    • Images gallery
    • Material type information
    • Ownership details

4. Auction System

  • Auction Browsing
    • List of all auctions
    • Auction cards with key info
    • Filter and search
    • Pull-to-refresh
  • Auction Details
    • Comprehensive auction information
    • Asset preview
    • Seller information
    • Current bid display
    • Timer countdown
    • Place bid functionality
    • Bid history
  • Create Auction
    • Mobile-optimized auction creation
    • Form validation
    • Asset selection
    • Auction type selection
  • Bid Management
    • View bids on auction
    • Place bids
    • Bid history

5. Shipment Tracking & Logistics

  • Shipment Management
    • View all shipments
    • Filter by status (all, active, seller, buyer)
    • Shipment list with status indicators
    • Pull-to-refresh
  • Shipment Details
    • Complete shipment information
    • Asset details
    • Pickup and delivery locations
    • Parties involved (seller, buyer, hauler)
    • Status timeline
    • Real-time status updates
    • Action buttons (role-based)
  • Live Tracking
    • Real-time GPS tracking
    • Live map view with hauler location
    • Pickup and delivery markers
    • Route visualization
    • ETA calculation
    • Distance tracking
    • Geofencing for automatic status updates
  • Proof of Delivery (POD)
    • Photo capture
    • Signature capture
    • Weight input
    • Seal number tracking
    • Notes and documentation
    • Location tagging
    • Upload to Firebase Storage
  • Shipment Chat
    • Real-time messaging
    • Role-based chat (seller, buyer, hauler)
    • Image attachments
    • System messages for status changes
    • Message read indicators
  • Issue Reporting
    • Report shipment issues
    • Issue types: delay, damage, quantity mismatch, quality, no-show, other
    • Photo evidence capture
    • Description and details
    • Issue status tracking (open, resolved, escalated)
    • Issue timeline view

6. Hauler Features

  • Hauler Profile
    • Profile setup and management
    • Driver's license upload and verification
    • Insurance information and document upload
    • Vehicle details (type, make, model, year, license plate, max weight)
    • Service area selection (multi-state)
    • Max distance preference
    • Verification status
  • Job Management
    • Available jobs list
    • Active jobs tracking
    • Completed jobs history
    • Job filters (available, active, completed)
    • Job details view
  • Job Details
    • Asset information
    • Route information (pickup and delivery)
    • Distance and estimated payout
    • Navigation to external maps (Google Maps, Apple Maps)
    • Status updates
    • Accept/decline job functionality
    • POD capture integration
  • Navigation
    • One-tap navigation to external maps
    • Turn-by-turn directions
    • Route optimization

7. Dashboard & Statistics

  • Dashboard Screen
    • WARM environmental metrics
    • Sales statistics
    • Auction statistics
    • Shipment statistics
    • Hauler job statistics (if hauler)
    • Interactive charts
    • Recent activity overview
  • Statistics
    • Total bids placed
    • Assets owned
    • Unique bale types
    • Sales metrics
    • Environmental impact metrics (WARM)

8. Notifications

  • Notification System
    • Push notifications (FCM)
    • In-app notifications
    • Notification history
    • Notification settings
    • Deep linking from notifications
  • Notification Types
    • Auction updates
    • Bid notifications
    • Shipment status changes
    • Hauler assignments
    • Issue reports
    • Chat messages

9. Settings & Configuration

  • Settings
    • Notification settings
    • Security settings
    • App configuration
    • Theme preferences (dark/light mode)
  • Support
    • Support/help screen
    • Contact information

Shared Features

1. WARM Integration

  • WARM Analysis
    • Waste and Recycling Management system integration
    • Material analysis
    • Environmental impact metrics
    • Material type validation
    • WARM-compliant material types

2. Exchange Rate Integration

  • ETH/USD Exchange Rates
    • Real-time exchange rate fetching
    • Fallback mechanisms
    • Price conversion utilities

3. Real-time Updates

  • Firebase Realtime Listeners
    • Real-time auction updates
    • Real-time shipment tracking
    • Real-time chat messages
    • Real-time location updates

4. Image Management

  • Image Upload
    • Firebase Storage integration
    • Multiple image support
    • Image optimization
    • Profile picture management

Role-Based Access Control

Available Roles

  1. Admin - Full system access, configuration management
  2. Municipality - Can create auctions, create assets (Mixed Recyclables only)
  3. Hauler - Can create assets, manage shipments, accept jobs
  4. MRF (Material Recycling Facility) - Can create auctions, bid on Mixed Recyclables auctions
  5. Transportation Company - Can create assets
  6. Broker - Can create auctions, bid on all auction types
  7. Remanufacturer/Mill - Can bid on non-Mixed Recyclables auctions
  8. Landfill - Basic access

Role Permissions Matrix

FeatureAdminMunicipalityHaulerMRFTransportationBrokerRemanufacturer/MillLandfill
Create Auction❌*✅❌✅❌✅❌❌
View Auctions✅❌❌✅❌✅✅❌
Bid on Auctions❌*❌❌✅**❌✅**✅***❌
Create Assets✅✅✅✅✅✅✅✅
System Config✅❌❌❌❌❌❌❌
Shipment Tracking✅✅✅✅✅✅✅✅
Hauler Jobs✅❌✅❌❌❌❌❌

*Admin inherits permissions of assigned role
**Can bid on Mixed Recyclables auctions
***Can bid on other material type auctions

Blockchain & Smart Contracts

Smart Contracts

  1. AuctionFactory

    • Factory contract for creating auctions
    • NFT minting
    • Asset creation on blockchain

  2. EnglishAuction

    • Ascending bid auction mechanism
    • Bid management
    • Escrow functionality
    • Payment release on delivery confirmation

  3. DutchAuction

    • Descending price auction mechanism
    • Automatic price reduction
    • Instant purchase capability
    • Refund mechanism

  4. FixedPriceSale

    • Fixed price sales
    • Direct purchase functionality

  5. ERC721Mintable

    • NFT standard implementation
    • Asset tokenization
    • Ownership tracking

Blockchain Features

  • NFT Minting
    • Each asset is minted as an NFT
    • Unique token IDs
    • Ownership tracking on-chain
  • Escrow System
    • Payment held in escrow until delivery confirmation
    • Buyer confirmation required
    • Grace period for seller withdrawal
  • Payment Release
    • Automatic payment release on delivery confirmation
    • Seller withdrawal after grace period
    • Refund mechanisms for overpayment

Backend Services

Firebase Cloud Functions

  1. Authentication Functions

    • generateNonce - Generate authentication nonces
    • signInUser - User sign-in with wallet signature
    • getUserProfile - Get user profile
    • updateUserProfile - Update user profile
    • cleanupExpiredNonces - Admin cleanup function

  2. Asset Functions

    • createAsset_V2 - Create and mint assets
    • Asset validation
    • WARM material type validation

  3. Auction Functions

    • createAuction_V2 - Create auctions on blockchain
    • deployAuctionFactory - Deploy factory contract
    • Auction status management
    • Transaction tracking

  4. Shipment Functions

    • onAuctionStatusChange - Auto-create shipments
    • createShipmentForAuction - Manual shipment creation
    • getShipmentForAuction - Get shipment for auction
    • onShipmentStatusChange - Status change handler
    • Notification dispatch

  5. WARM Functions

    • computeValues - WARM analysis
    • getAnalysisResults - Get analysis results
    • uploadMaterialsRows - Upload material data
    • WARM - HTTP endpoint

  6. Spreadsheet Functions

    • getAllSheetNamesIds - Get sheet information
    • getSheetId - Get sheet ID
    • getCellValue - Get cell value
    • getCellValues - Get multiple cell values

  7. Scheduled Functions

    • scheduleForMarkingEnglishAuctionComplete - Mark auctions complete

Firebase Services

  • Firestore Database
    • User profiles
    • Assets collection
    • Auctions collection
    • Shipments collection
    • Transactions collection
    • Notifications collection
    • Hauler profiles
    • Location history
    • Chat messages
  • Firebase Storage
    • Asset images
    • Profile pictures
    • POD photos
    • Document uploads
  • Firebase Authentication
    • User authentication
    • Wallet-based auth
    • Social auth (Google)
  • Firebase Cloud Messaging
    • Push notifications
    • Notification templates
    • Notification history

Key Differentiators

  1. Blockchain Integration

    • Full blockchain integration for asset ownership
    • NFT-based asset representation
    • Smart contract-based auctions
    • Escrow system for secure payments

  2. Comprehensive Logistics

    • End-to-end shipment tracking
    • Real-time GPS tracking
    • Hauler marketplace
    • Proof of delivery system

  3. Role-Based Ecosystem

    • Multiple stakeholder roles
    • Role-specific permissions
    • Material type restrictions
    • Auction access controls

  4. Environmental Focus

    • WARM integration
    • Environmental impact metrics
    • Sustainable economy focus
    • Material recycling tracking

  5. Real-Time Features

    • Real-time auction updates
    • Live shipment tracking
    • Real-time chat
    • Push notifications

Technical Highlights

Web Application

  • Modern React.js architecture
  • Redux for state management
  • Responsive design
  • Dark/light theme support
  • Real-time updates via Firestore listeners

Mobile Application

  • React Native with Expo
  • TypeScript for type safety
  • Native mobile features (camera, GPS, maps)
  • Offline support capabilities
  • Push notifications
  • Deep linking

Backend

  • Serverless architecture (Cloud Functions)
  • Real-time database (Firestore)
  • Scalable storage (Firebase Storage)
  • Secure authentication
  • Rate limiting and security measures

Future Enhancements (Noted in Codebase)

  1. Hauler Marketplace

    • Public job board
    • Distance-based matching
    • Price/bid system for jobs
    • Load optimization

  2. Ratings & Reviews

    • Post-delivery ratings
    • Hauler ratings
    • Rating-based matching

  3. SMS Notifications

    • Twilio integration
    • SMS for critical events

  4. Advanced Analytics

    • Enhanced reporting
    • Business intelligence
    • Predictive analytics

Conclusion

BESSE is a comprehensive platform that combines blockchain technology, real-time tracking, and role-based access control to create a complete ecosystem for waste and recycling material management. The platform successfully bridges the gap between traditional waste management and modern blockchain technology, providing transparency, security, and efficiency in the recycling economy.

Report Generated: January 29, 2026
Platform Version: Current Development Version
Status: Active Development

Curriculum Integration