🚀 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.

🚀 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.

🚀 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