🚀 HyperSonic – The Ultimate AI-Powered Meme Coin Hub

Live on: https://hypersonic.vercel.app/

🧠 Problem

Launching, trading, and promoting meme coins is fragmented and chaotic. From managing liquidity and avoiding rugs, to tracking market sentiment and finding alpha—users are forced to juggle multiple tools and platforms just to keep up.

💡 Solution

HyperSonic streamlines the entire meme coin lifecycle—from token creation and social engagement to predictive analytics and community betting—using multi-agent AI systems and battle-tested smart contracts. Whether you're a trader, creator, or degenerate gambler, we give you an AI-powered edge in the memecoin economy.

Built on Sonic Labs and integrated with MetaMask SDK for frictionless Web3 onboarding, HyperSonic lets users interact with tokens, agents, and AI models all from one intuitive interface.

🌐 Powered by MetaMask SDK

HyperSonic uses the MetaMask SDK to offer secure, scalable, and production-ready wallet connectivity for Web3 users. From session persistence and automatic reconnection to custom signer workflows and multi-device support, MetaMask SDK powers seamless wallet integration across the entire HyperSonic dApp stack.

No more dropped sessions. No janky wallet popups. Just fast, stable, and secure wallet interactions — as it should be.

🔌 MetaMask Implementation Details

Here's a summary of where and how MetaMask is used in the codebase:

MetaMask SDK Integration:

• The application uses the MetaMask SDK (@metamask/sdk and @metamask/sdk-react packages) for wallet integration.
• The SDK is set up in frontend/app/providers/MetaMaskSDKProvider.tsx which configures the MetaMask provider with app-specific settings.

Utility Functions (frontend/app/utils/metamask.ts):

• getMetaMaskProvider(): Gets an Ethereum provider from MetaMask
• addChainToMetaMask(): Adds a custom chain to MetaMask
• switchChainInMetaMask(): Switches to a specific chain in MetaMask

Wallet Provider (frontend/app/providers/WalletProvider.tsx):

• Creates a React context that manages wallet connection state
• Uses the MetaMask SDK via useSDK() hook
• Handles chain changes via MetaMask event listeners
• Provides utility methods like connect(), disconnect(), and getContract()

Connect Button Component (frontend/app/components/MetaMaskConnectButton.tsx):

• UI component for connecting to MetaMask
• Uses wagmi hooks for wallet interaction
• Displays wallet address, balance, and network information when connected
• Offers disconnect functionality
• Used in the site header and navbar components

App Provider Configuration (frontend/app/providers.tsx):

• Sets up wagmi with the MetaMask connector
• Wraps the application with MetaMaskSDKProvider

The application is built with strong MetaMask integration, offering multiple connection methods (direct provider, SDK-based, and store-based fallback) for maximum compatibility across different environments. It's designed to handle both browser extension and mobile wallet scenarios.

🚀 Contract Address

Sonic Mainnet

• Network name: Sonic
• RPC URL: https://rpc.soniclabs.com
• Explorer URL: https://sonicscan.org
• Chain ID: 146
• Currency symbol: S

Contracts on mainnet:

• Factory: 0xF52593b79C6a6c48DE918C1a3469959029DC3a8e
• Launchpad Agent: 0xC699def0dB413Bff70192Fd986a20d4bFFa02641
• Native Liquidity Pool: 0xaC348bAB58b649a41DC23D108e90d949A8852fa0
• Bookie Bet: 0x7cebb1bae1e148c1f1a0f30b306e898da05f12dc

Contracts on testnet:

• Factory: 0x202CCe504e04bEd6fC0521238dDf04Bc9E8E15aB
• Launchpad Agent: 0xf4B146FbA71F41E0592668ffbF264F1D186b2Ca8
• Native Liquidity Pool: 0x172076E0166D1F9Cc711C77Adf8488051744980C
• Bookie Bet: 0xd1b6BEa5A3b3dd4836100f5C55877c59d4666569

🎯 Key Features

1. Sonic Tailored Chatbot

• An AI chatbot specialized in Sonic Labs queries, leveraging Retrieval-Augmented Generation (RAG) for real-time, accurate responses.
• Ask anything about Sonic, including "What Makes Sonic Unique?," "Fee Monetization (FeeM) Mechanism on Sonic: Incentive Innovation in the Blockchain Ecosystem," etc.
• Ask questions like:
  • "What is Sonic Gateway?"
  • "How does Sonic boost transaction throughput from 2,000 TPS to 10,000 TPS?"
  • "How does Sonic's consensus mechanism integrate Asynchronous Byzantine Fault Tolerance?"

2. 🚀 Interactive Memecoin Launchpad with Anti-Rug Mechanism

• AI-powered token generation and deployment
• Fair launch mechanics with anti-rug pull protection
• 10-day linear vesting schedule and 1 month of liquidity locking to prevent rug
• Custom bonding curve for sustainable fundraising
• Automated liquidity management, enforcing liquidity locks to prevent token creators from exiting early.
• Easily launch tokens via web, chatbot, or Twitter—just submit a joke or meme idea!
• Buy and swap tokens effortlessly through chat—just a few clicks to confirm transactions

3. 🎲 Betting Marketplace

• Place bets on meme coin trends, price movements, and crypto events
• Web interface and Twitter integration (@HyperSonic46406)
• Fully transparent, on-chain execution for trustless betting
• Smart contract-secured fund management
• Category-based filtering and easy stake positioning

4. 🤖 Multi-Agent AI Framework

• News Agent: Real-time crypto news monitoring
• Token Analysis Agent: Market trend analysis
• Price Prediction Agent: Allora-powered AI forecasts. Optimized to detect topic IDs from fetchAllTopics() in the Allora SDK
• Dex Flow Agent: Enables seamless token buys/swaps with Sonic, requiring only the token address
• Social Sentiment Agent: Cross-platform sentiment analysis
• Search Agent: New token discovery
• Swap Agent: Optimal liquidity pool routing
• Whale Watch Agent: Large-scale transaction monitoring
• Twitter Agent: AI-driven social engagement on X, posting and interacting on meme coin trends in real time

5. 📢 AutoShill (Powered by Zerepy)

• Automated viral tweet generation – Crafts engaging and high-impact tweets to maximize visibility.
• Trending discussion engagement – Identifies and participates in relevant trending topics to boost reach.
• Dynamic social media presence management – Maintains a consistent and interactive brand presence.
• Smart reply system – Responds intelligently to discussions, ensuring organic engagement.
• Anti-bot detection compliance – Ensures tweets comply with X's detection systems to prevent flagging
• Customizable shill strategies – Allows users to define parameters for targeted audience engagement.
• Seamless API integration – Easily connects with existing platforms for automated execution.

💻 Technology Stack

🎨 Frontend & UI

🔧 AI Framework

⛓️ Blockchain & Smart Contracts

📦 Storage & IPFS

📊 AI & Integration

🚀 Getting Started

Prerequisites

• Node.js 18+
• Crypto wallet (MetaMask)
• pnpm package manager

Installation

1. Clone the Repository

git clone https://github.com/stephanienguyen2020/hypersonic
cd hypersonic

2. Set Up Environment Variables

# Copy sample environment files
cp frontend/.env.example frontend/.env
cp eliza/.env.example eliza/.env
cp ZerePy/.env.example ZerePy/.env

# Configure your environment variables

3. Frontend Setup

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install
# or
yarn install
# or
pnpm install
# or
bun install

# Start the development server
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

This will start the frontend on http://localhost:3000.

4. Running the Eliza Agent

In a new terminal window:

cd eliza
pnpm install
pnpm build
pnpm start --character="characters/crypto-sage.json"

5. Running the ZerePy Agent

Follow the steps here to use the official installation: https://python-poetry.org/docs/#installing-with-the-official-installer

Extra installation after installing poetry

poetry self add poetry-plugin-shell
poetry install --extras server

In a new terminal window:

cd ZerePy
poetry install --no-root
poetry shell
poetry run python main.py --server

🌐 Access Points

• Frontend: http://localhost:3000
• ZerePy Agent: http://localhost:8000
• Eliza Agent: http://localhost:8000

👥 Built By

HyperSonic is developed by a cross-functional team of crypto-native engineers, AI researchers, and degens. Powered by MetaMask SDK, we're not just building tools, we're reshaping the meme economy.

🤝 Support

For support, please reach out to our team or join our community channels.