hackquest logo

SOLMate

SOLMate is an intelligent chat interface that connects users to the Solana blockchain through natural language conversations. Simply type what you want to do, and your SOLMate handles the rest.

Videos

Description

SOLMate - The AI That Speaks Your Wallet's Language

Live Site: SOLMate

SOLMate is an AI chat tool that makes using the Solana blockchain as easy as talking. Instead of dealing with complicated dApps or dashboard, users can just type what they want to do in simple language. By using MetaMask Embedded Wallet SDKs (Web3Auth Plug and Play), SOLMate lets people create a wallet instantly with just their social or email login. Everyday tasks like checking balances, swapping tokens, or sending payments become quick, easy conversations — perfect for beginners.

Problem: Web3 is still too complecated for most people. To check a balance, swap tokens, or transfer tokens, users have to move between different apps and dashboards, copy long wallet addresses, and worry about fees and technical terms. This confuses new users and makes even simple tasks feel like a chore.

Solution: SOLMate is a chat-based assistant that makes all of this simple. Users can just type what they want, like “What’s my SOL balance?” or “Swap 10 USDC to SOL,” and SOLMate will take care of it. It also explains each step in plain English so users feel confident.

Impact: With SOLMate, anyone can use Solana without needing to be an expert. This lowers the barrier for beginners, improves the experience for regular users, and helps grow adoption and activity across the Solana ecosystem.


🔒 Note on Security & Control

SOLMate does not take over user funds or execute transactions on its own. The AI provides a simple chat interface that prepares and explains actions like swaps or transfers in plain English. The final step is always verified and confirmed by the user in their wallet. This ensures that the experience stays easy while the user remains fully in control of their assets.


✨ Core Features

🧠 AI-Powered Conversational Interface

  • Natural Language Processing: Advanced AI understands complex wallet queries and commands

  • Intent Recognition: Automatically categorizes requests (queries vs actions) for precise responses

  • Context Awareness: Maintains conversation context for seamless multi-step operations

  • Clarification Support: Users can ask “why” or “how” questions to better understand transactions and learn along the way

  • Smart Error Handling: Provides helpful guidance when commands are unclear or incomplete

💼 Comprehensive Wallet Analytics

  • Real-time Portfolio Tracking: Live balance monitoring for SOL and 50+ SPL tokens

  • Transaction History Analysis: Detailed transaction categorization with smart filtering

  • NFT Collection Management: View, analyze, and track your complete NFT portfolio

💰 Advanced Market Intelligence

  • Live Price Data: Real-time pricing via Moralis API for comprehensive market coverage

  • Market Trends: Track gainers, losers, and emerging opportunities

⚡ Seamless Transaction Execution

  • Jupiter Integration: Best-in-class DEX aggregation for optimal swap rates.

  • Natural Language Swaps: "Swap 5 SOL to USDC" → Instant execution with price protection

  • Domain Resolution: Support for .sol domains (e.g., send to "alice.sol")

  • Smart Gas Management: Automatic fee optimization and transaction prioritization

  • Transaction Simulation: Preview transactions before execution for safety

💸 Solana Pay Integration

  • QR Code Generation: Create payment requests with visual QR codes

  • Deep Wallet Links: Direct integration with Phantom, Solflare, and other wallets

  • Payment Tracking: Real-time payment status monitoring and history

  • Multi-Token Payments: Accept payments in SOL or any SPL token


🔐 Web3Auth Usage

  • Web3Auth Embedded Wallet: Integrated using the MetaMask Embedded Wallet SDK (Web3Auth Plug and Play)

  • Simple UI for Connection: When a user starts an action (like checking balance, swap, or transfer), the system prompts them to connect their wallet through a Web3Auth-powered modal.

  • Social & Email Login: Sign in with Google, Twitter, GitHub, or email — no seed phrase needed.

  • Cross-Device Sync: Wallet access continues across devices using the same social/email login.

  • Transaction Flow:

    1. User gives a command (e.g., "Swap 10 USDC to SOL").

    2. SOLMate prepares the transaction and shows details in plain English.

    3. Web3Auth wallet pops up for confirmation.

    4. The user reviews and approves.


�️ Technology Stack

  • Front-End: Next.js, React-19, Tailwind CSS, Motion

  • AI & Data Processing: OpenAI API, Vercel AI SDK

  • Blockchain & Web3: Solana Web3.js, Jupiter API, Bonfida Name Service and SolPay

  • Authentication: Web3Auth


🎯 Example Commands & Use Cases

Wallet Management

"What's my SOL balance?"
"Show me all my token balances"
"What's my portfolio worth in USD?"
"Display my recent transactions"
"Show me my NFT collection"

💱 Token Swaps

"Swap 5 SOL to USDC"
"Convert 100 USDT to JUP"
"Exchange 1000 BONK for RAY"
"Swap half my SOL for USDC"

💸 Payments & Transfers

"Send 0.5 SOL to alice.sol"
"Transfer 100 USDC to [wallet address]"
"Create a payment request for 2 SOL"
"Generate QR code for 50 USDC payment"

📊 Market Analysis

"What's the current SOL price?"
"Which tokens are trending down?"
"What's the market cap of JUP?"
"Give me a market overview"

🛠️ Getting Started

Prerequisites: Node.js 18+, Git

Quick Setup

# Clone the Repository
git clone https://github.com/rayaanr/SOLMate.git
cd SOLMate

# Install Dependencies
npm install

# Environment Configurationcp .env.example .env.local

# Replace ENV variables with actual Keys

# Start Development Server
npm run dev

# Open Your Browser and Navigate to http://localhost:3000

Built with ❤️ for the Solana ecosystem with MetaMask

SOLMate is more than an AI Chat - it's the bridge that brings Web3 to everyone.


Progress During Hackathon

SOLMate was started at the beginning of the MetaMask Embedded Wallets & Solana Dev Cook-Off hackathon, and everything was built during the event period — from identifying the problem, brainstorming and designing the solution, to implementing the core features and deploying a working demo.

Tech Stack

Next
Web3
Solana
Web3Auth
Jupyter
SolPay
Team LeaderRRayaan
Sector
AIDeFi