Space : The Future of Social Spaces

Read more detailed on Github : https://github.com/cadalt0/space/

# Crypto Social Space Platform - Project Description

## 🚀 Project Overview

The Crypto Social Space Platform is a Next.js-based web application that creates blockchain-secured social spaces for crypto communities at real-world events. Built on Solana with Web3Auth integration, this platform enables secure, trustless interactions where community members stake SOL as collateral to participate in event-specific spaces.

## 🎯 The Problem We Solve

### Current Pain Points in Crypto Communities

**Trust Issues at Events:**
- Scammers and fake profiles at crypto meetups
- Unreliable vendors and shops at conferences
- People not paying their share of group expenses
- Items borrowed but never returned
- No accountability for bad behavior

**Fragmented Social Experience:**
- Disconnected social interactions at crypto events
- No unified platform for event-specific commerce
- Limited ways to monetize community participation
- Lack of reputation systems for real-world interactions
- No financial incentives for good community behavior

## 💡 Our Solution

### Core Innovation: Blockchain-Secured Social Spaces

We've created a social platform where every interaction is secured by blockchain technology, creating a trustless environment where community members have real skin in the game through SOL staking.

### Key Features

#### 1. **Web3Auth & SNS Integration**
- **Web3Auth Wallet Connection**: Seamless wallet connection using Web3Auth modal
- **SNS Profile Creation**: Every user must create an on-chain SNS (Solana Name Service) profile
- **Enhanced Auth Guard**: Multi-layered authentication requiring both profile and stake
- **Minimum Stake Requirement**: 0.001 SOL minimum to participate in spaces

#### 2. **Event-Specific Social Spaces**
- **Search & Discovery**: Find spaces by event name or city using the homepage search
- **Space Creation**: Community members can create spaces for specific events
- **Feature Toggle**: Each space can enable/disable specific features (shops, lend, request, hangout)
- **Admin Controls**: Space creators can set rules and moderation
- **3D Space Scene**: Interactive 3D visualization using Three.js

#### 3. **Onchain Commerce (Shops)**
- **Shop Listings**: Crypto-enabled shops listed in spaces
- **Community Rating**: On-chain upvote/downvote system for shops
- **Space-Specific Shops**: Shops are tied to specific event spaces
- **Reputation System**: Good shops earn more visibility through voting

#### 4. **IRL Item Lending**
- **Physical Item Lending**: Lend real-world items (cameras, laptops, chargers)
- **Custom Security Deposits**: Set minimum stake requirements for borrowers
- **Space-Specific Items**: Items are tied to specific event spaces
- **Community Voting**: Dispute resolution through community voting

#### 5. **Community Requests**
- **Paid Requests**: Request services, items, or help from community
- **Budget Setting**: Set payment amounts for completed requests
- **Space-Specific Requests**: Requests are tied to specific event spaces
- **Service Marketplace**: Community members can fulfill requests for crypto

#### 6. **Safe Hangouts**
- **Meetup Planning**: Organize social gatherings with crypto security
- **Space-Specific Hangouts**: Hangouts are tied to specific event spaces
- **Behavior Reporting**: Report bad behavior or rule violations
- **Community Justice**: Voting system to penalize rule breakers

#### 7. **On-Chain Voting System**
- **Program ID**: `5zQieQbJebHJdxpURBSswrVbHWtKXZHx6EF1gEzNrXZp`
- **Upvote/Downvote**: Direct on-chain voting for all content types
- **PDA Management**: Program Derived Addresses for secure voting
- **Transaction Signing**: Web3Auth integration for transaction signing

## 🏗️ Technical Architecture

### Frontend Stack
- **Framework**: Next.js 15.2.4 with React 19
- **UI Components**: Radix UI with Tailwind CSS
- **3D Graphics**: Three.js with React Three Fiber
- **State Management**: React hooks and local state
- **Forms**: React Hook Form with Zod validation

### Blockchain Integration
- **Network**: Solana Devnet (`https://api.devnet.solana.com`)
- **Wallet**: Web3Auth Modal for Solana
- **SNS Integration**: `@bonfida/spl-name-service` for on-chain identity
- **Smart Contracts**: Custom programs for staking and voting
- **Transaction Handling**: Web3Auth's `useSignAndSendTransaction` hook

### Smart Contract Programs

#### Staking Program
- **Program ID**: Custom staking program
- **Vault System**: Program Derived Addresses for user vaults
- **Instructions**: `init_vault` and `deposit` instructions
- **Minimum Stake**: 0.001 SOL (0.0001 SOL minimum validation)

#### Voting Program
- **Program ID**: `5zQieQbJebHJdxpURBSswrVbHWtKXZHx6EF1gEzNrXZp`
- **Instructions**: `upvote` and `downvote` with discriminators
- **PDA Seeds**: `[b"item", item_id]` and `[b"vote_tracker", item_id, voter]`
- **Vote Tracking**: Prevents double voting through vote tracker PDAs

### Data Management
- **Database**: In-memory mock database (JSON-based)
- **Data Types**: Spaces, Shops, LendItems, Requests, Hangouts
- **Voting**: Local vote count updates with blockchain verification
- **Persistence**: Currently mock data, ready for database integration

## 🎮 User Journey

### New User Onboarding
1. **Wallet Connection**: Connect via Web3Auth modal
2. **SNS Profile Creation**: Create on-chain SNS identity
3. **Initial Staking**: Stake minimum 0.001 SOL
4. **Space Discovery**: Search for events or cities
5. **Feature Exploration**: Explore shops, lending, requests, hangouts

### Active User Experience
1. **Space Participation**: Join event-specific spaces
2. **Commerce**: Buy/sell items, rate shops
3. **Lending**: Borrow/lend physical items
4. **Community**: Create requests, plan hangouts
5. **Governance**: Vote on content, report issues

### Authentication Flow
1. **Web3Auth Check**: Verify wallet connection
2. **SNS Profile Check**: Verify on-chain identity exists
3. **Stake Verification**: Check minimum stake requirements
4. **Action Authorization**: Allow/deny based on requirements

## 💰 Economic Model

### Staking Economics
- **Minimum Stake**: 0.001 SOL to participate
- **Validation**: 0.0001 SOL minimum for transactions
- **Vault System**: User funds locked in Program Derived Addresses
- **Security**: Stakes act as collateral for platform participation

### Fee Structure
- **Transaction Fees**: Solana network fees only
- **No Platform Fees**: Currently no additional fees
- **Gas Optimization**: Efficient transaction batching

### Token Economics
- **SOL as Primary Currency**: All transactions in SOL
- **SNS Integration**: On-chain identity verification
- **Voting Power**: Based on stake amount and participation

## 🔒 Security Features

### Smart Contract Security
- **Program Derived Addresses**: Secure account management
- **Discriminator Validation**: Instruction validation through discriminators
- **Vote Tracking**: Prevents double voting through PDA system
- **Vault System**: Secure staking with user-controlled vaults

### User Protection
- **Multi-Layer Auth**: Web3Auth + SNS + Staking requirements
- **Enhanced Auth Guard**: Comprehensive permission system
- **Stake Requirements**: Financial skin in the game
- **Community Voting**: Decentralized content moderation

### Data Privacy
- **On-Chain Identity**: SNS profiles for verification
- **Local State**: Sensitive data handled client-side
- **Wallet Integration**: User controls their own keys