Skip to content

AP3X-Dev/SOL-CHAT

BranchesTags

Repository files navigation

πŸš€ SOL-CHAT

The Future of Decentralized Communication

A revolutionary peer-to-peer messaging platform built on Solana blockchain featuring end-to-end encryption, real-time communication, username NFTs, and world-class user experience.

SOL-CHAT Banner

License: MIT Solana TypeScript React

✨ Overview

SOL-CHAT has been completely transformed into a next-generation decentralized messaging platform that rivals Discord, Telegram, and WhatsApp while maintaining true Web3 principles. With revolutionary features like username NFTs, real-time communication, advanced encryption, and a stunning user interface, SOL-CHAT represents the future of digital communication.

🌟 Revolutionary Features

πŸ” Military-Grade Security

  • End-to-End Encryption: Advanced encryption with forward secrecy
  • Message Signing: Cryptographic verification of message authenticity
  • Ephemeral Keys: New encryption keys for every message
  • Zero-Knowledge: Your private keys never leave your device

οΏ½ Next-Gen Messaging

  • Real-time Communication: Instant message delivery via WebSocket
  • 1-1 & Group Chats: Direct messaging and group conversations
  • Rich Media: Send text, images, files, and voice messages
  • Message Reactions: Express yourself with emoji reactions
  • Threading: Reply to specific messages with context
  • Typing Indicators: See when others are typing
  • Read Receipts: Know when messages are delivered and read

πŸ‘€ Username NFT System

  • Claim Your Identity: Register unique usernames as NFTs
  • Solana Name Service: Full SNS integration and compatibility
  • Tradeable Assets: Username NFTs can be bought, sold, and transferred
  • Verification System: Verified badges for authenticated users
  • Rarity Tiers: Legendary, Epic, Rare, and Common usernames

🎨 World-Class UI/UX

  • Modern Design: Beautiful glassmorphism effects and Solana gradients
  • Smooth Animations: 60fps animations powered by Framer Motion
  • Three-Panel Layout: Chat sidebar, main chat, and persistent peer list
  • Dark/Light Themes: Stunning themes that adapt to your preference
  • Mobile Responsive: Perfect experience on all devices
  • Accessibility: Full keyboard navigation and screen reader support

⚑ Performance & Scalability

  • Virtual Scrolling: Handle thousands of messages smoothly
  • Message Caching: Lightning-fast loading of conversations
  • Optimistic Updates: Instant UI feedback for better UX
  • Offline Support: Queue messages when disconnected
  • Real-time Sync: Seamless synchronization across devices

Tech Stack

  • Frontend

    • React 18 with TypeScript for a robust component-based architecture
    • Tailwind CSS for responsive and customized styling
    • Lucide React for consistent, high-quality icons
    • Vite for fast development and optimized builds

  • Blockchain Integration

    • Solana Web3.js for blockchain interactions
    • Wallet Adapter for seamless Phantom wallet integration
    • Public key-based user identification

  • Security & Storage

    • TweetNaCl for military-grade end-to-end encryption
    • IPFS/Helia for decentralized file storage
    • LocalStorage for efficient message persistence and offline access
    • Message signing for authentication and integrity verification

Getting Started

Prerequisites

  • Node.js 18 or higher
  • A Solana wallet (e.g., Phantom)
  • Git (optional)

Installation

  1. Clone the repository:
git clone https://github.com/AP3X-Dev/SOL-CHAT.git
cd SOL-CHAT
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and navigate to http://localhost:5173 (or the port shown in your terminal)

Configuration (Optional)

For IPFS integration, create a .env file in the root directory:

VITE_WEB3_STORAGE_EMAIL=your_email@example.com
VITE_WEB3_STORAGE_SPACE=your_space_did

Note: The application works without IPFS configuration, but file storage will be limited to local storage.

Usage

  1. Connect Wallet

    • Click the "Select Wallet" button on the welcome screen
    • Approve the connection in your Phantom wallet
    • Set up your username when prompted to complete your profile

  2. Navigate the Interface

    • View your recent conversations in the main panel
    • Browse quick actions for upcoming features (marked with "Soon" indicators)
    • See your recent peers in the side panel (open by default)
    • Toggle dark/light mode with the theme button in the header

  3. Send Messages

    • Enter recipient's Solana address or select from recent peers
    • Type your message in the input field
    • Click the send button (gradient arrow) to encrypt and transmit
    • View message status indicators for sent messages

  4. Manage Contacts

    • Browse your recent peers in the side panel
    • Set nicknames for easy identification by clicking the edit icon
    • Monitor peer activity status with the status indicators
    • Click on a peer to start a new conversation

  5. Share Files

    • Click the paperclip icon to attach files
    • Supported formats: images, PDFs, documents, text files
    • Preview images directly in the chat
    • Click on images to view them in the full-screen modal

Security Features

  • End-to-End Encryption: All messages are encrypted using TweetNaCl's box encryption with public/private key pairs
  • Blockchain Authentication: Wallet-based authentication ensures message integrity and sender verification
  • Decentralized Storage: Messages are stored locally with optional IPFS backup for enhanced privacy
  • No Central Server: Direct peer-to-peer communication model eliminates central points of failure
  • Message Signing: Digital signatures verify the authenticity of each message
  • Local Data: Sensitive information never leaves your device without encryption

Development

Project Structure

SOL-CHAT/
β”œβ”€β”€ public/                # Static assets
β”‚   β”œβ”€β”€ logo.png           # Application logo
β”‚   └── solana-icon.svg    # Solana icon
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/        # React components
β”‚   β”‚   β”œβ”€β”€ MessageInput.tsx    # Message composition
β”‚   β”‚   β”œβ”€β”€ MessageList.tsx     # Conversation display
β”‚   β”‚   β”œβ”€β”€ PeerList.tsx        # Contact management
β”‚   β”‚   β”œβ”€β”€ ProfileSetup.tsx    # User onboarding
β”‚   β”‚   β”œβ”€β”€ RecipientInput.tsx  # Address selection
β”‚   β”‚   β”œβ”€β”€ ThemeProvider.tsx   # Dark/light mode
β”‚   β”‚   └── WalletContextProvider.tsx  # Wallet integration
β”‚   β”œβ”€β”€ lib/               # Core functionality
β”‚   β”‚   β”œβ”€β”€ crypto.ts      # Encryption utilities
β”‚   β”‚   β”œβ”€β”€ ipfs.ts        # IPFS integration
β”‚   β”‚   β”œβ”€β”€ peers.ts       # Peer management
β”‚   β”‚   β”œβ”€β”€ profile.ts     # User profiles
β”‚   β”‚   └── storage.ts     # Data persistence
β”‚   β”œβ”€β”€ types/             # TypeScript definitions
β”‚   β”œβ”€β”€ App.tsx            # Main application
β”‚   β”œβ”€β”€ index.css          # Global styles
β”‚   └── main.tsx           # Application entry point
└── tailwind.config.js     # Tailwind CSS configuration

Building for Production

npm run build

The optimized production build will be generated in the dist directory, ready for deployment to your preferred hosting service.

Key UI Features

  • Dark Mode: Sleek dark theme with Solana-inspired gradient accents
  • Responsive Design: Fully responsive layout that works on desktop and mobile devices
  • Interactive Elements: Smooth animations and transitions for a polished user experience
  • Accessibility: High contrast text and interactive elements for better readability
  • Intuitive Navigation: Clear visual hierarchy and consistent UI patterns

Roadmap

The following features are planned for future development:

  • New Chat: Streamlined interface for starting new conversations with any Solana address
  • Contacts Management: Advanced contact organization with groups and favorites
  • Message Archive: Searchable history of all conversations with filtering options
  • Group Messaging: Create chat rooms with multiple participants
  • Enhanced File Sharing: Support for larger files and more formats
  • Profile Customization: Additional profile settings and avatar support

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Solana Foundation for blockchain infrastructure and inspiration
  • IPFS for decentralized storage capabilities
  • TailwindCSS team for the excellent styling framework
  • Lucide for the beautiful icon set
  • The Web3 community for ongoing support and innovation

Support

For support, please open an issue in the GitHub repository or reach out to the maintainers.

Built with ❀️ by AP3X-Dev

About

A secure, decentralized peer-to-peer messaging application built on Solana blockchain with end-to-end encryption and file sharing capabilities.

Topics

blockchain chat-application crytpocurrency solana

Resources

Readme
Activity

Stars

5 stars

Watchers

1 watching

Forks

7 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages