Solana Bootcamp Projects

This repository contains the tasks from the RiseIn Solana Bootcamp, January 2024.

Solana Review Project - README

Welcome to the Web3 Review project repository! This decentralized solana-based project from RiseIn's Solana Bootcamp leverages blockchain technology to implement a review platform on the Solana network. Participants can add, update and view reviews.

Table of Contents

• Overview
• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Smart Contracts
• Frontend
• Contributing

Overview

The Web3 Review provides a user-friendly interface to participate in Solana-based reviews. This project ensures transparency and trust in the local business or product review process through the use of smart contracts. Think of it as the Decentralised Yelp. Users can add and update reviews, as well as see other reviews.

Features

• Add reviews.
• Update reviews.
• Browse reviews by other reviewers.
• Solana Wallet Integration: Connect your Solana wallet to participate directly (For now, you have to be on the Solana Devnet).

Getting Started

Follow these steps to set up the project locally and start participating in the decntralised solana-based reviews.

Prerequisites

1. Crypto Wallet: Ensure you have a Phantom or Solflare wallets installed on your browser.

2. Navigate to testnet (Devnet) network in your choosen wallet.

3. Get your to SOL tokens at https://faucet.solana.com

Installation

1. Clone the repository:

  git clone https://github.com/Ikpong-Joseph/RiseIn-SolanaBootcamp-FinalProject.git

2. Navigate to the project directory ~/4-FinalProjectFrontendUpdates in your terminal

3. Install required npm packages:

 npm install

If you encounter any npm errors during install, run

npm update

Usage

1. Start the development server:

npm start

2. Open your web browser and navigate to http://localhost:3000 to access the page.

3. Connect your Solana wallet via button on top right corner.

4. Browse ongoing auctions, place bids, and monitor your auction activity.

Smart Contracts

The Rust smart contracts in this project facilitate the review process. They handle adding and updating reviews. These contracts are deployed on the Solana Devnet.

• lib.rs: Handles the broad logic of creating transactions, adding and updating reviews.
• instruction.rs: Defines the program's instruction data for executing the program.
• state.rs: Oversees the basic state of the program and handles some common errors.

Frontend

The review page frontend is built using modern web technologies including React.js.

• React.js: Powers the DApp's user interface.
• solana/web3.js , solana/wallet-adapter-react: The Solana JavaScript API for smart contract interaction.
• Phantom / Solflare: Solana wallets for secure transactions.

Contributing

Contributions to this project are welcome! To contribute:

1. Fork the repository.
2. Create a new branch for your feature/bug fix.
3. Make changes and test thoroughly.
4. Commit with clear and concise messages.
5. Push changes to your fork.
6. Submit a pull request describing your changes.

---

Thank you for your interest in the Web3 Review project! For questions or suggestions, reach out to us or open an issue on GitHub. Happy reviewing! 🚀