🔍 WaitWhat.sol

Paste any Solana transaction. Get a plain English explanation.

Built for the Solana Frontier Hackathon 2026 | Powered by AI + Solana web3.js

---

The Problem

Every Solana user has done this: you paste a transaction hash into Solscan, and you're hit with a wall of base58 addresses, program IDs, instruction logs, and lamport values you can't parse. Even experienced crypto users struggle to quickly understand what a transaction actually did.

There is no tool that bridges this gap cleanly.

The Solution

WaitWhat.sol — paste a transaction signature, get a human-readable explanation in seconds.

Input:  5j7s8K9mNpQr...AB

Output: "You swapped 10 USDC for 0.045 SOL on Raydium. 
         The transaction cost 0.000005 SOL in fees and 
         completed successfully at 2:34 PM on April 13, 2026."

It also flags suspicious activity — unknown programs, large unexpected drains, unusually complex transactions.

---

Features

• ✅ Plain English explanation of any Solana transaction
• 🤖 AI-powered (OpenAI GPT) with rule-based fallback
• 🔍 Identifies protocols — Raydium, Jupiter, Orca, Metaplex, and more
• ⚠️ Suspicious activity detection
• 💸 SOL and SPL token transfer parsing
• 🌐 Clean web UI + REST API
• ⚡ Built on Node.js + @solana/web3.js

---

Tech Stack

Layer	Technology
Runtime	Node.js
Blockchain	@solana/web3.js
AI	OpenAI GPT-3.5
Backend	Express.js
Frontend	Vanilla HTML/CSS/JS

---

Getting Started

# Clone the repo
git clone https://github.com/prathignas/waitwhat-sol
cd waitwhat-sol

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Add your OPENAI_API_KEY and SOLANA_RPC_URL to .env

# Run the server
npm start

Open http://localhost:3000 in your browser.

---

API Usage

GET /api/explain/:signature

Example:

curl http://localhost:3000/api/explain/5j7s8K9mNpQr...

Response:

{
  "signature": "5j7s8K9mNpQr...",
  "status": "✅ SUCCESS",
  "timestamp": "2026-04-13T14:34:00.000Z",
  "explanation": "You swapped 10 USDC for 0.045 SOL on Raydium. Fee was 0.000005 SOL. Transaction succeeded.",
  "details": {
    "feePayer": "7xKp...abc",
    "fee": "0.000005 SOL",
    "programsUsed": ["Raydium AMM", "Token Program (SPL Token)"],
    "solTransfers": [...],
    "tokenTransfers": [...]
  },
  "warnings": []
}

---

Project Structure

waitwhat-sol/
├── src/
│   ├── index.js       # Express server + API routes
│   ├── fetcher.js     # Solana RPC transaction fetcher + parser
│   └── explainer.js   # AI explanation engine
├── public/
│   └── index.html     # Frontend UI
├── .env.example       # Environment variables template
├── package.json
└── README.md

---

Roadmap

• Wallet history — explain last N transactions for a wallet
• Batch explanation — paste multiple signatures
• Mobile app (React Native)
• Chrome extension for Solscan integration
• Support for more protocols (Drift, Marginfi, etc.)
• Share explanations as image cards (for Twitter)

---

Built By

prathignas — Solana Frontier Hackathon 2026

---

License

MIT