Sandesh-Pyakurel/Bidding

BidSecure

Overview

BidSecure is a secure web application designed for online auctions. Bidders can place bids on available auctions, and auctioneers can post items for auction. BidSecure leverages Nillion network to ensure secure bidding, protecting users from data leakage and ensuring a safe and trustworthy auction experience.

Features

• Secure Bidding: Utilizes Nillion Network to provide secure bidding mechanisms.
• Auction Posting: Auctioneers can easily post items for auction.
• User-Friendly Interface: Intuitive design for both bidders and auctioneers.
• Search for items: Get results for specific items.
• Real-Time Updates: Live updates on auction status and bid placements.

Table of Contents

• Installation
• Usage
  • For Bidders
  • For Auctioneers
• Demo
• Security
• Contributing
• License

Installation

You need to have nillion-sdk installed. Follow through the given link to install it.

Now create a virtual environment, activate it and install the requirements.

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Now you need to start the local nillion network.

cd auction/nillion
./bootstrap-local-environment.sh
cd ../..

Run migrate command.

python3 manage.py migrate

You need to have redis-server installed in you machine. You can install it with:

sudo apt install redis-server

Then start it with:

sudo systemctl start redis-server

Now we can run the application. Run following 4 commands in seperate terminal.

python manage.py runserver
python manage.py tailwind start
celery -A bidding beat --loglevel=info
celery -A bidding worker --loglevel=info

Prerequisites

• Python

Usage

For Bidders

1. Register/Login:

   • Create an account or log in with your existing credentials.

2. Browse Auctions:

   • View a list of available auctions and detailed information about each item.

3. Place a Bid:

   • Select an auction and enter your bid amount.
   • Bids are securely processed using Nillion Network.

4. Monitor Auctions:

   • Track your bids and get real-time updates on auction status.

For Auctioneers

1. Register/Login:

   • Create an account or log in with your existing credentials.

2. Post an Auction:

   • Click on "Add Auction" and fill out the item details, including title, description, and starting bid.

3. Manage Auctions:

   • View your posted auctions.
   • Monitor bids and auction progress.

Demo

Thank.you.1.mp4

Security

BidSecure prioritizes the security and privacy of user data. We use Nillion Network to ensure that all bids are encrypted and securely processed, preventing data leakage and unauthorized access. For more details, visit the Nillion website.

Contributing

We welcome contributions to BidSecure! Please follow these steps to contribute:

1. Fork the Repository: Click the "Fork" button on GitHub to create your copy.

2. Clone Your Fork:

   git clone https://github.com/Sandesh-Pyakurel/Bidding.git

3. Create a Branch:

   git checkout -b your-branch-name

4. Make Changes: Implement your changes.

5. Commit Your Changes:

   git commit -m "Description of your changes"

6. Push Your Changes:

   git push -u origin your-branch-name

7. Create a Pull Request: Submit your changes for review.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Thank you for using BidSecure! Happy bidding!