ASSERT Backend

📌 Project Overview

This is the backend for the ASSERT Prediction Platform, a blockchain-based system where users can participate in predictions using AT tokens. The backend handles user authentication, token transactions, daily rewards, and interactions with the smart contract deployed on Ganache.

🚀 Features

• User Authentication (Signup & Login with email and password)
• Wallet Integration (Users can add their wallet address later)
• AT Token Transactions
  • Claim daily rewards (Configurable via .env file)
  • Deduct tokens for participation in predictions (Configurable via .env file)
  • Check user token balance (Syncs with blockchain)
• Smart Contract Interaction
  • Transfers tokens using Web3.js
  • Ensures on-chain balance sync with MongoDB

🛠️ Technology Stack

• Node.js & Express.js (Backend Framework)
• MongoDB & Mongoose (Database)
• Web3.js (Blockchain Integration)
• Ganache (Ethereum Local Blockchain for Testing)
• dotenv (Environment Variable Management)
• bcrypt.js & jsonwebtoken (User Authentication)

---

📥 Installation Guide

1️⃣ Clone the Repository

git clone https://github.com/your-username/your-repo.git
cd your-repo

2️⃣ Install Dependencies

npm install

3️⃣ Setup .env File

Create a .env file in the root directory and configure the following variables:

PORT=5000
MONGO_DB_CONNECTION_URI=your_mongo_db_uri
PRIVATE_KEY=your_ganache_private_key
RPC_URL=http://127.0.0.1:7545  # Ganache RPC URL
DAILY_TOKEN=20  # Amount of AT tokens users receive as a daily reward
TOKEN_DEDUCTION=5  # Amount of AT tokens deducted when participating in predictions
JWT_SECRET=your_generated_secret_here  # JWT Secret for authentication

⚠️ Note: Use the private key from the first account in Ganache.

4️⃣ Generate a Secure JWT Secret Key

You can generate a strong JWT secret key using any of the following methods:

Using Node.js Console

node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"

Using OpenSSL (Linux & macOS)

openssl rand -hex 64

Using Python

python -c "import secrets; print(secrets.token_hex(64))"

Copy the generated key and paste it into your .env file under JWT_SECRET.

5️⃣ Start the Backend Server

npm run start-dev  # For development with nodemon
npm run start      # For production

---

🔗 How to Use This Backend with Your Own Smart Contract & Wallet

🛠 Steps to Deploy Your Own Smart Contract

1. Modify and Deploy Your Own Smart Contract in Remix

   • Go to Remix Ethereum IDE
   • Write your Solidity contract (or modify the existing AT token contract)
   • Deploy it on Ganache
   • Copy the Contract Address after deployment

2. Update web3.js in the Backend

   • Open web3.js in your project
   • Replace the contract address with your own
   • Update the ABI if you modified the smart contract

const contractAddress = "0xYourContractAddressHere";  // Replace this
const contractABI = [...];  // Replace with your contract's ABI

3. Restart the Backend

npm run start-dev

4. Test api/v1 Endpoints with Your Own Wallet
   • Use Postman or cURL to test token transactions.

---

📡 api/v1 Endpoints

🔹 Authentication Routes

METHOD	ENDPOINT	DESCRIPTION
POST	/api/v1/auth/signup	Register a new user
POST	/api/v1/auth/login	Login and receive a JWT token

🔹 User Routes

METHOD	ENDPOINT	DESCRIPTION
POST	/api/v1/users	Register a new user
PUT	/api/v1/users/add-wallet	Add a wallet address to an existing user
GET	/api/v1/users/:id	Get a single user by ID
GET	/api/v1/users	Get all users

🔹 Token & Smart Contract Routes

METHOD	ENDPOINT	DESCRIPTION
PUT	/api/v1/users/token/claimDailyReward	Claim daily AT tokens (Configurable in .env)
PUT	/api/v1/users/token/deductTokens	Deduct AT tokens from a user (Configurable in .env)

---

📜 License

This project is MIT Licensed.

👥 Contributors

• Asif Hossain (@rafin31)

Feel free to fork, contribute, or suggest improvements! 🚀