⚡ Fully On-Chain AI Messaging

Every message is a verified blockchain transaction

---

🚀 Live App

👉 https://shelbychat.vercel.app/

Connect wallet → Send message → Pay gas → On-chain confirmation ⚡

---

✨ Core Features

Feature	Description
🤖 AI Engine	Groq (Llama 3) + HuggingFace models
⛽ Gas Mechanism	0.0025 SHELBY_USD per message
🔗 On-Chain Proof	Every chat stored as transaction
👛 Wallet Auth	Petra Wallet integration
💾 Persistence	Local storage session
⚡ Realtime	Fast AI response

---

🌐 Network Configuration

Network   : Shelby Testnet

RPC       : https://api.shelbynet.shelby.xyz/shelby
Fullnode  : https://api.shelbynet.shelby.xyz/v1
Indexer   : https://indexer.shelby.xyz
Explorer  : https://explorer.shelby.xyz/shelbynet
          : https://explorer.aptoslabs.com/?network=shelbynet
Faucet    : https://docs.shelby.xyz/apis/faucet/shelbyusd
          : https://docs.shelby.xyz/apis/faucet/aptos

---

💧 Get Testnet Assets

APT (Gas Fees)

👉 https://docs.shelby.xyz/apis/faucet/aptos

ShelbyUSD (Chat Fees)

👉 https://docs.shelby.xyz/apis/faucet/shelbyusd

Quick Steps

1. Open faucet link
2. Connect Petra Wallet
3. Claim tokens
4. Start chatting

---

📦 Installation

git clone https://github.com/gunduul/shelbychat.git
cd shelbychat
npm install

# Environment Variables
echo "GROQ_API_KEY=your_key_here" > .env
echo "HF_API_KEY=your_key_here" >> .env

# Run locally
vercel dev

---

📁 Project Structure

shelbychat/
├── api/
│   ├── balance.js
│   ├── chat.js
│   ├── prices.js
│   └── view.js
├── public/
├── index.html
├── vercel.json
├── package.json
└── README.md

---

🧠 Execution Flow

Wallet Connection
      ↓
User Message Input
      ↓
Gas Fee Confirmation
      ↓
Transaction Submission
      ↓
AI Processing (Groq / HF)
      ↓
Response Returned
      ↓
Stored On-Chain

---

🔗 Ecosystem Links

Resource	URL
🌐 Live App	https://shelbychat.vercel.app/
🔎 Explorer	https://explorer.shelby.xyz/shelbynet
💧 Faucet	https://docs.shelby.xyz/apis/faucet/shelbyusd
📡 Docs	https://docs.shelby.xyz
👛 Petra Wallet	https://petra.app

---

⚠️ Important Notes

• Testnet balance is required
• No gas = failed transaction ❌
• All messages are permanently recorded on-chain

---

🏁 Deployment

vercel deploy

---

👑 GUUNDUUL 👑

On-Chain AI Messaging is not the future — it's already here.

⭐ Star the repo if you support Web3 innovation