https://github.com/praptisharma28/peerproof
A trust-first, Web3-powered resale marketplace for real-world items :)
https://github.com/praptisharma28/peerproof
blockchain fastapi mongodb nft react smart-contracts solana solanapay vite web3
Last synced: 4 months ago
JSON representation
A trust-first, Web3-powered resale marketplace for real-world items :)
- Host: GitHub
- URL: https://github.com/praptisharma28/peerproof
- Owner: praptisharma28
- Created: 2025-06-08T11:08:12.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-14T20:44:42.000Z (about 1 year ago)
- Last Synced: 2025-09-05T05:50:14.133Z (10 months ago)
- Topics: blockchain, fastapi, mongodb, nft, react, smart-contracts, solana, solanapay, vite, web3
- Language: TypeScript
- Homepage: https://peer-proof.vercel.app/
- Size: 89.8 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧾 PeerProof
> **A Trustless, Escrow-Powered Peer-to-Peer Marketplace**
> Built on **Solana**, backed by **MongoDB Atlas**, and secured through **wallet-based identity** & **on-chain NFT reputation badges**.
Live Frontend: [peer-proof.vercel.app](https://peer-proof.vercel.app)
---
## 🔥 Features
* ✅ Wallet-based login via Phantom (no signup)
* 🔐 Escrow-based P2P transactions
* 🛡 On-chain reputation NFTs for trustless trading
* 💬 Fast, modern UI for buyers/sellers
* 🪙 Solana Pay flow (signature-based)
* 📦 MongoDB Atlas for scalable data backend
---
## 🖼 Demo Screenshots
---
## 🧠 How It Works
1. Users log in with Phantom wallet (Solana)
2. They create listings for secondhand items
3. Buyers send funds to escrow (Solana Pay)
4. Sellers mark as delivered, buyer confirms
5. Escrow is released, NFT badges minted for both
---
## 🧱 Tech Stack
| Layer | Technology |
| ----------- | ----------------------------- |
| Frontend | Next.js (Deployed via Vercel) |
| Backend | FastAPI (Python) |
| DB | MongoDB Atlas |
| Wallet Auth | Phantom Wallet |
| Payments | Solana Pay |
| Infra | Dockerized backend |
---
## 🧪 Local Development
### 🔧 Prerequisites
* Python 3.10+
* Docker & Docker Compose (optional)
* MongoDB Atlas URI
### 🔑 Setup `.env`
Create a `.env` file:
```env
MONGO_URI=mongodb+srv://name:name@123@name.70mjbna.mongodb.net/?retryWrites=true&w=majority&appName=name
```
## 🛠 Setup Guide (Backend)
### 1. Clone this repo
```bash
git clone https://github.com/praptisharma28/peerproof-backend.git
cd peerproof-backend
```
### 2. Create a virtual environment
```bash
python3 -m venv venv
source venv/bin/activate
```
### 3. Install dependencies
```bash
pip install -r requirements.txt
```
---
## 🚀 Running with Docker
### 1. Build the Docker Image
```bash
docker build -t peerproof-backend .
```
### 2. Run the Container
```bash
docker run -d -p 8000:8000 --env-file .env peerproof-backend
```
Now open your browser at:
👉 `http://localhost:8000/docs`
## 💜 Built with Love by
**[Prapti](https://github.com/praptisharma) & [Gamandeep](https://github.com/gamandeepsingh) for Web3 community!**
> For Solana, for the people — and for trustless commerce.