WinScan - Multi-Chain Blockchain Explorer

Modern, feature-rich blockchain explorer for Cosmos ecosystem with EVM support

Features • Quick Start • Documentation • Supported Chains • Contributing

---

✨ Features

🔍 Core Explorer

• Real-time Blockchain Data - Blocks, transactions, accounts with live updates
• Validator Monitoring - Uptime tracking, performance analytics, global node distribution
• Governance System - Vote on proposals directly from the explorer
• Multi-Asset Support - Track balances, holders, and token transfers

⚡ Advanced Capabilities

• EVM Support - Dual Cosmos + EVM explorer for hybrid chains (Shido, Uptick, Warden, XRPL)
• IBC Cross-Chain - Track IBC transfers, channels, and packet lifecycle
• PRC20 Tokens - Token verification, price charts, swap interface, liquidity pools
• Developer Tools - Endpoint checker, state sync generator, peer discovery

🤖 Automation Services

• Telegram Monitor Bot - Validator alerts & governance notifications (32+ chains)
• IBC Relayer Service - Automated packet relaying with web UI (35+ chains)
• Auto-Compound Bot - Automated staking rewards compounding

🌍 User Experience

• Multi-Language - 7 languages (EN, ID, JP, KR, CN, ES, RU)
• Wallet Integration - Keplr, Leap, Cosmostation
• Modern Dark UI - Sleek, responsive, mobile-optimized
• PWA Ready - Installable Progressive Web App
• Smart Caching - 5-min cache with background refresh for optimal performance

---

🚀 Quick Start

# Clone repository
git clone https://github.com/winsnip-official/winscan.org.git
cd winscan.org

# Install dependencies
npm install

# Setup environment (optional - only if you have custom backend)
cp .env.example .env

# Run development server
npm run dev

Visit http://localhost:3000

Available Scripts

npm run dev              # Development server
npm run build            # Production build
npm start                # Production server
npm run chain:add        # Add new chain interactively
npm run chain:validate   # Validate chain configs

🚀 Deploy to Vercel

✨ No environment variables required!

The app works out-of-the-box using RPC/API from chain config files (Chains/*.json). Just click deploy and it works!

Optional: If you have a custom backend API, set these in Vercel Project Settings:

• NEXT_PUBLIC_API_URL - Your backend URL
• NEXT_PUBLIC_DEFAULT_CHAIN - Default chain (e.g., paxi-mainnet)

📚 Homepage & Branding Guide | Chain Configuration

---

📖 Documentation

🎨 Customization

• Homepage & Branding - Configure homepage, loading screen, logo
• Chain Configuration - Add your blockchain to WinScan

🤖 Automation

• IBC Relayer - Automated IBC packet relaying
• Telegram Bot - Real-time alerts
• Auto-Compound - Automated staking

🛠️ Contributing

• Contributing Guide - How to contribute
• Security Policy - Report vulnerabilities
• Deployment Guide - Deploy to production

---

💎 Supported Chains

🌟 Mainnets (19 Chains)

AtomOne • Axone • BitBadges • CNHO Stables • CosmosHub • Gitopia • Humans.ai • Lava • Lumera • Noble • Osmosis • Paxi • Shido ⚡ • Sunrise • Tellor • Uptick ⚡ • Warden ⚡ • XRPL EVM ⚡ • Zenrock

🧪 Testnets (11 Chains)

AtomOne • CosmosHub • Empeiria • Kiichain • Lumera • Noble • Osmosis • Safrochain • Warden • XRPL EVM • Zenrock

⚡ EVM Compatible - Supports both Cosmos and EVM transactions with WebSocket real-time updates

🔗 Want to add your chain? See CHAIN-GUIDELINES.md

---

🛠️ Tech Stack

Frontend: Next.js 14 • TypeScript • Tailwind CSS 4.x • React
Blockchain: CosmJS • Cosmos SDK • ethers.js 6.x
Wallets: Keplr • Leap • Cosmostation
Charts: Recharts • Canvas API
Performance: React Window • Custom caching strategies

---

🤝 Contributing

We welcome contributions! Whether fixing bugs, adding features, or improving docs.

Quick Guide:

1. Fork this repository
2. Create branch: git checkout -b feature/amazing-feature
3. Commit: git commit -m 'feat: add amazing feature'
4. Push: git push origin feature/amazing-feature
5. Open Pull Request to dev branch

⚠️ Always target dev branch, not main

📚 Full guide: CONTRIBUTING.md

---

📞 Support & Community

Platform	Link
🌐 Website	winsnip.xyz
🤖 Telegram Bot	@winscan_monitor_bot
💬 Telegram	t.me/winsnip
🐦 Twitter	@winsnip
💻 GitHub	github.com/winsnip-official
📧 Email	admin@winsnip.xyz

---

📜 License

© 2025 WinSnip Official. All Rights Reserved.

Licensed under MIT License with Additional Restrictions.

✅ Allowed: Use, modify, distribute
❌ Prohibited: Remove branding, claim as your own
⚠️ Required: Maintain attribution to WinSnip

See LICENSE for full terms.

---

💖 Support the Project

Your sponsorship helps us add more chains, improve performance, and develop new features!

💰 Donation Addresses

Support us directly via crypto donations:

🔷 EVM (Ethereum/BSC/Polygon) 0x903c119b85750f851be45d915625d0bfd7181300 MetaMask, Trust Wallet, etc.

🟠 Bitcoin (BTC) bc1qqh6zwp8vwj5u5unp98jy4k320dy70n4v9ecqac Any Bitcoin wallet

🟣 Solana (SOL) FrqjvcLTgEwW8uUtJPJNoHq7ASWgKXJS8g1GZ1YjvHos Phantom, Solflare, etc.

Thank you for your support! 🙏

---

Made with ❤️ by WinSnip

If you find this project useful, please give it a ⭐️

Built on Trusted Infrastructure | Powered by Cosmos SDK | EVM Compatible