Skip to content

Repository files navigation

🚀 Stellar Feedback & Reward dApp

🔗 Live Demo

Live App


🎥 Demo Video

Watch Demo Video


📌 Description

This is a complete end-to-end Stellar MVP dApp built on the Stellar Testnet using Freighter Wallet.

The application allows users to:

  • Connect wallet
  • Submit anonymous feedback
  • Store feedback on-chain
  • Fetch feedback from blockchain
  • Receive token rewards

This project demonstrates real-world MVP validation with actual users.


🎯 Core Focus

Anonymous Feedback dApp with user validation + reward system using smart contracts.


🔌 Smart Contract Integration (Frontend Calls)

  • send_feedback → Stores feedback on-chain
  • fetch_feedback → Retrieves feedback
  • send_feedback_and_reward → Inter-contract call for reward

🏗️ Architecture Document

  • Frontend: React
  • Blockchain: Stellar Testnet
  • Smart Contracts: Soroban
  • Wallet: Freighter
  • Deployment: Vercel

Flow:
User → React UI → Freighter → Smart Contract → Blockchain → UI


🔄 How It Works

  1. User connects Freighter wallet
  2. User submits feedback
  3. Feedback stored on blockchain
  4. Feedback fetched & displayed
  5. Token reward sent

🟢 Features

Level 1

  • Wallet Connect / Disconnect
  • Display Balance
  • Send XLM

Level 2

  • Smart contract integration
  • Feedback storage
  • Fetch feedback

Level 3

  • Loading states
  • Error handling
  • Full UI flow

Level 4

  • Inter-contract calls
  • Token reward system
  • Production-ready contracts

👥 Testnet Users (Validated)

The following real users tested the application:

  1. GCTTFOWRDZ6NSNKIHLPJYTDW3I2PLY25HPG5KBSG7F4IXLIXA7QD5TEP
  2. GCLACDLBPPYGIPAAGXGMMLUQTOFS2XVEOR763NUBYMYIC2RRAOPRADNJ
  3. GCFL72LTYYVA7HTEC2NYT3AKHYS5CUG5LG26Z5LB667QRDAOFDILH6E7
  4. GAD4RU2SEIQWXKKYYCPTAOT66BVWHJGIS2GI2CMMX327BYFDYZUBOXIM
  5. GALGHBSNXLWND3FI2QKHEMVYVOCMVGJMDR6GTOWPYXMOCXRKRO5TYK53

🧪 How Users Tested

Each user:

  • Connected wallet
  • Submitted feedback
  • Verified transaction on blockchain
  • Checked feedback retrieval

📊 User Feedback Data

View Google Sheet (Excel Export)


🧠 Feedback Analysis

  • Users found app easy to use
  • Feedback submission working correctly
  • Minor UI/UX improvements suggested

🔄 Iteration (IMPORTANT)

🧾 User Feedback

  • UI slow during submission
  • Loading unclear
  • Mobile UI needs improvement

🚀 Improvements Implemented

  • Added loading states
  • Improved responsiveness
  • Enhanced UX

🔗 Commit Proof

https://github.com/RAHULRaa123/stellar-feedback-dapp/commit/19607a8e6fdb5f002fdb701d0b6c2cdec7fd08c0


🧠 Smart Contracts

Feedback Contract

CBXTSVTRCTXSJYYTGGV6G5R3F4EI73B3QW3SZ2MAZXMFEW445VQW7MOJ

Token Contract

CCUNRZQPLTIPELMXVCIMDLZP3B4RLXJCGB3NPWHDUNFJNVATKAGIRPAJ

Caller Contract

CCRR3NARGJ6UYRKW7N42KVN6KL6VXEHXA7AHYMB7URS7T7FIE35XCLJC


🔗 Transaction Proof

https://stellar.expert/explorer/testnet/tx/f498be49a48fd79f2fe7f4ff6a53ec09df5f911ed631ae34f2e18bde448c480c


📸 Screenshots

Inter Contract Fetch Feedback Mobile View


⚡ Performance

  • Loading states
  • Error handling
  • Optimized contract calls

🧪 Tests

  • Feedback submission ✔
  • Empty feedback validation ✔
  • Feedback count ✔
  • Smart contract call ✔

All tests passing ✅

Tests


⚙️ CI/CD Pipeline

  • GitHub Actions integrated
  • Auto build + test
  • Auto deploy via Vercel

CI Badge

CI

GitHub Actions: https://github.com/RAHULRaa123/stellar-feedback-dapp/actions


🚀 Future Scope

  • Real-time feedback updates
  • Analytics dashboard
  • Advanced rewards system
  • UI/UX improvements

👨‍💻 Author

Rahul Saini

About

Stellar Feedback & Reward dApp - Anonymous feedback system with on-chain storage and token rewards using Soroban smart contracts.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages