diff --git a/backend/disputeHandler.js b/backend/disputeHandler.js
new file mode 100644
index 00000000..5548c86d
--- /dev/null
+++ b/backend/disputeHandler.js
@@ -0,0 +1,10 @@
+const express = require('express');
+const router = express.Router();
+
+router.post('/', async (req, res) => {
+ const { escrowId, reason } = req.body;
+ // TODO: Log dispute and notify admin
+ res.json({ escrowId, status: 'dispute logged', reason });
+});
+
+module.exports = router;
diff --git a/backend/escrowController.js b/backend/escrowController.js
new file mode 100644
index 00000000..ca073248
--- /dev/null
+++ b/backend/escrowController.js
@@ -0,0 +1,17 @@
+const express = require('express');
+const router = express.Router();
+
+router.post('/initiate', async (req, res) => {
+ const { buyerId, sellerId, amount } = req.body;
+ const escrowId = Date.now(); // Simple unique ID
+ // TODO: Save to database or in-memory store
+ res.json({ escrowId, status: 'pending' });
+});
+
+router.post('/release/:id', async (req, res) => {
+ const escrowId = req.params.id;
+ // TODO: Validate and release funds
+ res.json({ escrowId, status: 'released' });
+});
+
+module.exports = router;
diff --git a/backend/index.js b/backend/index.js
new file mode 100644
index 00000000..8ccd24f8
--- /dev/null
+++ b/backend/index.js
@@ -0,0 +1,25 @@
+const express = require('express');
+const cors = require('cors');
+const bodyParser = require('body-parser');
+
+const escrowController = require('./escrowController');
+const reputationService = require('./reputationService');
+const disputeHandler = require('./disputeHandler');
+
+const app = express();
+const PORT = process.env.PORT || 5000;
+
+app.use(cors());
+app.use(bodyParser.json());
+
+app.use('/api/escrow', escrowController);
+app.use('/api/reputation', reputationService);
+app.use('/api/dispute', disputeHandler);
+
+app.get('/', (req, res) => {
+ res.send('TrustSphere backend is running');
+});
+
+app.listen(PORT, () => {
+ console.log(`Server is running on port ${PORT}`);
+});
diff --git a/backend/reputationService.js b/backend/reputationService.js
new file mode 100644
index 00000000..143d9674
--- /dev/null
+++ b/backend/reputationService.js
@@ -0,0 +1,11 @@
+const express = require('express');
+const router = express.Router();
+
+router.get('/:userId', async (req, res) => {
+ const userId = req.params.userId;
+ // TODO: Replace with real scoring logic
+ const score = 80; // Placeholder score
+ res.json({ userId, score });
+});
+
+module.exports = router;
diff --git a/doc/api.md b/doc/api.md
new file mode 100644
index 00000000..46839427
--- /dev/null
+++ b/doc/api.md
@@ -0,0 +1,54 @@
+# TrustSphere API Documentation
+
+This document outlines the backend routes and logic for TrustSphereβs modular trust infrastructure.
+
+---
+
+## π Escrow Routes
+
+### `POST /api/escrow/initiate`
+Initiates an escrow transaction between buyer and seller.
+
+**Body Parameters:**
+- `buyerId`
+- `sellerId`
+- `amount`
+- `itemDescription`
+
+### `POST /api/escrow/release`
+Releases funds from escrow after successful transaction.
+
+**Body Parameters:**
+- `escrowId`
+- `confirmationCode`
+
+---
+
+## π Reputation Routes
+
+### `GET /api/reputation/:userId`
+Fetches the reputation score for a given user.
+
+**Params:**
+- `userId` (string)
+
+---
+
+## βοΈ Dispute Routes
+
+### `POST /api/dispute/submit`
+Submits a dispute for review.
+
+**Body Parameters:**
+- `transactionId`
+- `reason`
+- `evidence` (optional)
+
+---
+
+## π§ Notes
+
+- All routes expect JSON payloads.
+- Authentication is optional for demo purposes.
+- Future versions will include Pi user verification and dispute arbitration logic.
+
diff --git a/frontend/App.js b/frontend/App.js
new file mode 100644
index 00000000..a43f0d7a
--- /dev/null
+++ b/frontend/App.js
@@ -0,0 +1,20 @@
+import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
+import LandingPage from './LandingPage';
+import Escrow from './Escrow';
+import Reputation from './Reputation';
+import DisputeForm from './DisputeForm';
+
+function App() {
+ return (
+
+
+ } />
+ } />
+ } />
+ } />
+
+
+ );
+}
+
+export default App;
diff --git a/frontend/LandingPage.css b/frontend/LandingPage.css
new file mode 100644
index 00000000..101c576e
--- /dev/null
+++ b/frontend/LandingPage.css
@@ -0,0 +1,25 @@
+.landing-container {
+ padding: 2rem;
+ font-family: sans-serif;
+ background-color: #f9f9f9;
+ color: #333;
+}
+
+h1 {
+ color: #5c2d91;
+}
+
+.link-list {
+ list-style: none;
+ padding: 0;
+}
+
+.link-list li {
+ margin: 1rem 0;
+}
+
+.link-list a {
+ color: #5c2d91;
+ text-decoration: none;
+ font-weight: bold;
+}
diff --git a/frontend/LandingPage.js b/frontend/LandingPage.js
new file mode 100644
index 00000000..8355cb55
--- /dev/null
+++ b/frontend/LandingPage.js
@@ -0,0 +1,24 @@
+import React from 'react';
+import './LandingPage.css'; // Optional: for styling
+
+function LandingPage() {
+ return (
+
+
Welcome to TrustSphere
+
+ A modular trust infrastructure for the Pi economy β combining escrow, reputation scoring, and dispute resolution.
+
+
+
+