AI-powered blockchain wallet security scanner built for Celo & Stacks Mainnet and optimized for MiniPay & Bitcoin L2s.
TxGuard is a pay-as-you-go AI wallet security scanner that analyzes any blockchain wallet address and returns an instant risk score, scam detection alerts, and behavioral analysis — powered by Groq AI and GoPlus Security.
Built for the everyday crypto user — especially those on MiniPay across Africa and emerging markets — who need to verify a wallet before sending funds.
"Don't lose your crypto to scams. Scan first."
| Feature | Description |
|---|---|
| 🤖 AI Risk Scoring | Groq Llama-3 generates plain English risk assessments (0–100) |
| 🛡️ GoPlus Security | Scans against blacklists, phishing, honeypots, approval abuse |
| ⛓️ 5 Chains | Ethereum, BNB Chain, Solana, Bitcoin, and Celo |
| 💳 Pay-per-scan | 0.01 CELO per scan on Celo Mainnet |
| 📱 MiniPay Native | Auto-detects MiniPay, connects wallet, handles cUSD gas fees |
| 🧾 Onchain Receipts | Scan receipts paid on Celo, and auditable scan records logged to Stacks Mainnet |
| 💬 Ask AI | Chat with TxGuard AI about any scanned wallet |
| 📊 Transaction Breakdown | Categorizes wallet activity — Transfers, DeFi, Swap, NFT, Stablecoin |
Web App: txguard-gules.vercel.app
Inside MiniPay:
- Open MiniPay app
- Tap the browser icon
- Go to
txguard-gules.vercel.app - TxGuard auto-detects MiniPay and switches to Celo mode
| Property | Value |
|---|---|
| Network | Celo Mainnet |
| Contract Address | 0x20FFa15Ca89AfA1b855fD2ff4f0A4D453FfB0C10 |
| Type | TxGuardPayment.sol — Pay-per-scan contract |
| Scan Fee | 0.01 CELO per scan |
| Gas Currency | cUSD (MiniPay compatible) |
| Property | Value |
|---|---|
| Network | Stacks Mainnet |
| Contract Address | SP3QKY6WR398BJHPP23VKKEQXQ0T1H1HAQ1BKQFKM.registry |
| Type | registry.clar — Security scan registry contract |
| Functionality | Public auditing for target chains, wallet address, and risk scores |
payScan() // Pay for a wallet scan (payable)
scanFee() // Get current scan fee
totalScans() // Total scans processed
updateFee() // Update fee (owner only)
withdraw() // Withdraw collected fees (owner only)| Layer | Technology |
|---|---|
| Frontend | React + Vite |
| Styling | Custom CSS — glassmorphism, dark mode, responsive |
| AI | Groq API — Llama-3.1-8b-instant |
| Security DB | GoPlus Security API |
| Blockchain Data | Etherscan V2 API (ETH, BNB, Celo), Solana RPC, Blockstream (BTC) |
| Smart Contract | Solidity 0.8.20 — deployed on Celo Mainnet |
| Web3 | Injected window.ethereum — MiniPay & Valora compatible |
| Hosting | Vercel |
- Node.js v18+
- A Groq API key — console.groq.com
- An Etherscan API key — etherscan.io/apis
# Clone the repo
git clone https://github.com/jotel-dev/txguard.git
cd txguard/web
# Install dependencies
npm install
# Create environment file
cp .env.example .env
# Add your API keys to .env
# Start dev server
npm run devCreate a .env file inside web/:
VITE_GROQ_API_KEY=your_groq_api_key
VITE_ETHERSCAN_API_KEY=your_etherscan_api_key- Start your local dev server (
npm run dev) - Expose your port using ngrok:
ngrok http 5173- Copy the
https://...ngrok-free.appURL - Open MiniPay on your phone
- Enable Developer Mode — tap the version number repeatedly in Settings → About
- Go to Developer Settings → Load Test Page → paste the ngrok URL
- Scan a wallet and approve the Celo transaction!
Final Score = GoPlus Score (70%) + Behavioral Score (30%)
GoPlus Flags: Behavioral Signals:
- Blacklisted +80 - New wallet + high balance +20
- Phishing +75 - Zero transactions +10
- Ransomware +85 - Bot-like volume +15
- Mixer +40 - Established wallet -10
- Honeypot +50 - Normal activity pattern -5
Score Ranges:
0–25 → ✅ SAFE
26–50 → ⚠️ CAUTION
51–75 → 🚨 SUSPICIOUS
76–100 → 🔴 DANGEROUS
- AI wallet scanning — ETH, BNB, SOL, BTC, Celo
- GoPlus security integration
- Pay-per-scan smart contract on Celo Mainnet
- MiniPay hook — auto wallet detection + cUSD gas
- Onchain scan receipts
- Telegram Bot (@TxGuardBot)
- Stuck transaction detection
- Multi-wallet dashboard
- Stacks / Bitcoin L2 support
- Community scam reporting
MiniPay has 14M+ users across Africa and emerging markets — many of whom are new to crypto and vulnerable to scams. Existing security tools are desktop-first, require subscriptions, and speak to experienced users.
TxGuard is built for mobile-first, pay-as-you-go, plain language security — the right tool for the right people.
MIT © jotel-dev
- 🌐 Live App: txguard-gules.vercel.app
- 📜 Contract: celoscan.io
- 🐦 Twitter: @TxGuardBot coming soon
- 💬 Telegram Bot: @TxGuardBot coming soon
Built with ❤️ for Celo and Stacks ecosystems · Proof of Ship Season 2