QuoteSphere: Decentralized Quote Sharing Platform

QuoteSphere is a decentralized application (dApp) built on the Aptos blockchain that allows users to share, discover, and interact with quotes in a secure and transparent manner.

Project Purpose

The primary purpose of QuoteSphere is to create a decentralized platform where users can:

Share their favorite quotes
Discover quotes from others
Interact with quotes through likes
Maintain ownership and control over their shared content

Key Features

Quote Creation: Users can add custom quotes or fetch random quotes from an external API
Quote Storage: All quotes are stored on the Aptos blockchain
Like System: Users can like/unlike quotes, with the data stored on-chain
Search Functionality: Search for quotes by user address
Wallet Integration: Seamless integration with Aptos wallets (in this case Petra Wallet) for user authentication
Decentralized Ownership: Each user owns their quotes on the blockchain

Tech Stack

Blockchain: Aptos
Blockchain Network: Aptos Testnet Network
Smart Contract Language: Move
Frontend Framework: React
State Management: React Context API
Wallet Integration: @aptos-labs/wallet-adapter-react
UI Components: Ant Design (antd)
Network Interaction: Aptos SDK (Provider, Types)
External API: quotable.io (for random quotes)

Smart Contract Overview

The Move smart contract (Quotes.move) provides the following functionality:

Initialize the quote system for a user
Add new quotes
Toggle likes on quotes
Retrieve quotes for a specific address
Search quotes by address

Frontend Overview

The React frontend (QuoteProvider.tsx) offers:

Context for managing global state
Functions to interact with the smart contract
User interface for adding, viewing, and interacting with quotes

Getting Started

Smart Contract Deployment

Install the Aptos CLI following the official documentation.
Generate your module address and initialize your account:
```
aptos init
```
Choose testnet when prompted.
Compile the Move module:
```
aptos move compile
```
Publish the module:
```
aptos move publish
```
Confirm the transaction when prompted.
Note the account address output during initialization. You'll use this as your REACT_APP_MODULE_ADDRESS and my_addr.

Frontend Setup

Clone the repository and install dependencies:

git clone <repository-url>
cd <repository-name>
npm install

Create a .env file in the project root:

REACT_APP_MODULE_ADDRESS=<your-account-address>

Set up your Aptos wallet (Petra) and connect to the Testnet.
Run the application:
```
npm run start
```

Your dApp is now connected to your deployed smart contract on the Aptos testnet.

Usage

Connect your Aptos wallet to the dApp
Add custom quotes or fetch random ones
View quotes from other users
Like/unlike quotes
Search for quotes by user address

amandangol/quotesphere-on-aptos