Skip to content

winsnip-official/winscan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

WinScan - Multi-Chain Blockchain Explorer

WinScan Logo

Modern blockchain explorer for Cosmos ecosystem

Website License Twitter

Security Audit CodeQL CI/CD Known Vulnerabilities Dependencies

✨ Features

Core Features

  • 🌐 Multi-Chain Support - Cosmos SDK chains with IBC compatibility
  • πŸ“Š Real-Time Tracking - Live blocks, transactions, validators monitoring
  • πŸ’Ό Wallet Integration - Keplr, Leap, Cosmostation support
  • πŸ”— IBC Tracking - Cross-chain transfer monitoring
  • πŸ—³οΈ Governance - View and vote on proposals
  • πŸ“ˆ Validator Analytics - Uptime tracking, commission, voting power, 24h/7d/30d stats
  • 🌍 Multi-Language - 7 languages support (EN, ID, JP, KR, CN, ES, RU)
  • 🎨 Modern UI - Dark theme, responsive design
  • πŸ“± PWA Ready - Installable Progressive Web App with offline support

EVM Support

  • ⚑ EVM Explorer - Native support for Cosmos chains with EVM sidechain
  • πŸ” EVM Blocks - Real-time block tracking with gas statistics
  • πŸ’Έ EVM Transactions - Transaction details with gas info & hash copy
  • πŸ‘› EVM Addresses - Balance, transaction history, token holdings
  • πŸ”— Dual Chain - Seamless navigation between Cosmos & EVM
  • 🌐 WebSocket Support - Real-time updates via EVM WSS endpoints
  • ⚑ Parallel Fetching - Race condition for fastest API response
  • πŸ“Š Gas Analytics - Average gas used, gas limit tracking

Advanced Features

  • πŸ€– Auto-Compound Bot - Automated staking rewards compounding
  • πŸ“Š Token Analytics - Real-time price tracking, supply metrics
  • πŸ’° Asset Management - Multi-asset support, holder tracking
  • πŸ”„ State Sync - Fast node synchronization with active peers & seeds
  • πŸ” Endpoint Checker - Test RPC, API, gRPC, WSS, EVM endpoints connectivity
  • πŸš€ Performance - Optimized with caching, CDN, and stale-while-revalidate
  • πŸ“¦ Smart Caching - 5-minute cache with background refresh
  • πŸ”„ Auto-Refresh - 4-second background updates for real-time data
  • 🎯 Copy to Clipboard - One-click copy for hashes, addresses
  • πŸ“‹ Transaction Icons - Visual indicators for blocks, transactions
  • πŸ” Secure - Server-side API with CORS handling

πŸ€– Telegram Monitor Bot

  • πŸ“’ Real-Time Notifications - Instant alerts for validator missed blocks & governance proposals
  • πŸ—³οΈ Governance Alerts - Auto-notify when new proposals enter voting period
  • 🌐 Multi-Chain Support - Monitor 32+ Cosmos SDK chains simultaneously
  • ⚑ Smart Monitoring - Configurable thresholds, cooldown periods, anti-spam
  • πŸ“Š Live Statistics - Check active proposals, validator uptime, chain status
  • πŸ”— Direct Voting Links - One-click buttons to vote on WinScan
  • πŸš€ High Performance - Parallel API requests, backend proxy optimization

πŸ”— Try Now: @winscan_monitor_bot

πŸš€ Quick Start

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

# Install dependencies
npm install

# Run development server
npm run dev

Visit http://localhost:3000

πŸ“– Documentation

πŸ€– Auto-Compound Bot

WinScan includes a standalone auto-compound bot for validators to provide staking rewards compounding service to their delegators.

Key Features:

  • βœ… Automated rewards compounding using Authz grants
  • βœ… Multi-chain support (Cosmos SDK & EVM-compatible)
  • βœ… Validator commission claiming
  • βœ… Governance auto-voting
  • βœ… Configurable frequency (hourly/daily/weekly/monthly)

Quick Setup:

cd autocompound-bot
npm install
cp .env.example .env
# Edit .env with your mnemonic
npm run build
npm start

πŸ“š Full Documentation: autocompound-bot/README.md

πŸ“’ Telegram Monitor Bot

Real-time monitoring and alerts for Cosmos validators and governance!

The Telegram Monitor Bot provides instant notifications for validator performance issues and governance proposals across 32+ Cosmos SDK chains.

Key Features:

  • βœ… Missed Blocks Alerts - Get notified when validators miss blocks
  • βœ… Governance Notifications - Never miss a voting opportunity
  • βœ… Multi-Chain Support - Monitor 32+ chains simultaneously
  • βœ… Smart Thresholds - Configurable missed blocks limits
  • βœ… Anti-Spam - Cooldown periods prevent notification flooding
  • βœ… Direct Voting - One-click buttons to vote on WinScan
  • βœ… Live Statistics - Check active proposals and validator uptime

Available Commands:

/start       - Start the bot
/subscribe   - Subscribe to validator/chain alerts
/list        - View your subscriptions
/proposals   - Check active governance proposals
/stats       - View chain statistics
/unsubscribe - Remove subscriptions
/help        - Show all commands

Example Alerts:

Missed Blocks Alert:

⚠️ MISSED BLOCKS ALERT ⚠️

β”Œβ”€ πŸ”— Chain: AtomOne Mainnet
β”œβ”€ πŸ‘€ Validator: WinSnip Validator
β”œβ”€ πŸ“ Address: atonevaloper1xxx...
└─ ⚑ Missed: 50 blocks

🚨 Action Required!
Your validator has missed 50 blocks.
Please check your validator node immediately.

⏰ Alert will not repeat for 1 hour

Governance Proposal Alert:

πŸ—³οΈ NEW GOVERNANCE PROPOSAL πŸ—³οΈ

β”Œβ”€ πŸ”— Chain: AtomOne Mainnet
β”œβ”€ 🏷️ Proposal ID: #19
β”œβ”€ πŸ“ Title: Update dynamic min deposit
β”œβ”€ πŸ’¬ Description: During the v3 upgrade...
└─ πŸ—“οΈ Voting Period: 12/11/2025 ➜ 4 day(s) left

πŸ“’ Cast Your Vote!
Participate in governance to shape the future of AtomOne Mainnet.

[πŸ—³οΈ Vote on WinScan]
⏱️ Don't miss the voting deadline!

πŸ”— Start Monitoring: @winscan_monitor_bot

πŸ“š Full Documentation: telegram-monitor-bot/README.md

πŸ” Endpoint Checker

Test and validate your blockchain endpoints in real-time!

The Endpoint Checker is a powerful tool for validators and node operators to verify connectivity and performance of their endpoints.

Supported Endpoints:

  • βœ… Cosmos RPC - Tendermint RPC endpoint testing with block height & chain ID
  • βœ… Cosmos API/REST - REST API endpoint verification
  • βœ… gRPC/gRPC-Web - gRPC endpoint connectivity check
  • βœ… WebSocket - Real-time WebSocket connection testing
  • βœ… EVM JSON-RPC - Ethereum-compatible RPC testing (for EVM chains)
  • βœ… EVM WebSocket - EVM WebSocket connection validation

Key Features:

  • πŸ“Š Real-Time Testing - Test multiple endpoints simultaneously
  • ⚑ Latency Measurement - Accurate response time in milliseconds
  • πŸ“ˆ Block Height - Current block height verification
  • πŸ†” Chain ID - Automatic chain ID detection
  • 🎯 Auto-Fill - Pre-filled with chain's default endpoints
  • πŸ”„ Manual Override - Edit or add custom endpoints to test
  • πŸ“± Mobile Friendly - Fully responsive interface
  • 🌐 Multi-Language - Available in 7 languages

How to Use:

  1. Navigate to Tools β†’ Endpoint Checker
  2. Endpoints are auto-filled from chain configuration
  3. Modify or add custom endpoints as needed
  4. Click "Check All Endpoints"
  5. View results with latency, block height, and status

Example Results:

βœ… Cosmos RPC
   Latency: 45ms
   Block Height: 12,345,678
   Chain ID: paxi-mainnet

βœ… EVM JSON-RPC
   Latency: 38ms
   Block Height: 5,678,901
   Chain ID: 1234

Access: Navigate to any chain β†’ Tools β†’ Endpoint Checker

πŸ”„ State Sync with Active Peers

Fast node synchronization with live peer discovery!

The State Sync tool helps you quickly sync your node to the latest blockchain state without downloading the entire history.

Features:

  • πŸ“Š Live State Sync Info - Latest block height, trust height, and hash
  • 🌐 Active Peers Discovery - Automatically fetch top 10 most active peers
  • 🌱 Seed Nodes - Get reliable seed nodes for network bootstrapping
  • πŸ“‹ One-Click Copy - Copy individual peers/seeds or all at once
  • πŸ”§ Customizable - Configure service name and home directory
  • πŸ“ Auto-Generated Scripts - Ready-to-use bash scripts for quick setup
  • ⚑ Smart Selection - Peers sorted by activity score (bandwidth)
  • πŸ” RPC with Indexer - Automatically finds RPCs with tx_index enabled

How to Use:

  1. Navigate to Tools β†’ State Sync
  2. View current chain state (latest height, trust height, hash)
  3. Check active peers and seeds list
  4. Configure service name (e.g., paxid, lumerachain)
  5. Set home directory (e.g., $HOME/.paxi)
  6. Copy peers/seeds or use the automated script
  7. Run the script on your server

Generated Script Example:

#!/bin/bash

# Stop your node
sudo systemctl stop paxid

# Backup priv_validator_state.json
cp $HOME/.paxi/data/priv_validator_state.json $HOME/backup.json

# Reset database
paxid tendermint unsafe-reset-all --home $HOME/.paxi

# Configure state sync
sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\\1true|" $HOME/.paxi/config/config.toml
sed -i.bak -E "s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\\1${TRUST_HEIGHT}|" $HOME/.paxi/config/config.toml

# Add peers
PEERS="node1@ip1:26656,node2@ip2:26656"
sed -i.bak -E "s|^(persistent_peers[[:space:]]+=[[:space:]]+).*$|\\1\"$PEERS\"|" $HOME/.paxi/config/config.toml

# Start node
sudo systemctl start paxid

Access: Navigate to any chain β†’ Tools β†’ State Sync

πŸ”§ Configuration

Adding New Chains

  1. Create yourchain-mainnet.json in Chains/ directory
  2. Configure RPC, API endpoints, and token details
  3. See CHAIN-GUIDELINES.md for complete format

Environment Variables

NEXT_PUBLIC_API_URL=https://ssl.winsnip.xyz

πŸš€ Deployment

Vercel (Recommended)

npm run build
vercel --prod

Add environment variable in Vercel dashboard:

NEXT_PUBLIC_API_URL=https://ssl.winsnip.xyz

πŸ› οΈ Tech Stack

Category Technology
Framework Next.js 14 (App Router)
Language TypeScript
Styling Tailwind CSS
Icons Lucide React
Charts Recharts
API REST (WinSnip Public)
Wallet Keplr / Leap / Cosmostation
EVM ethers.js, JSON-RPC
Blockchain CosmJS, Cosmos SDK

πŸ“œ License & Copyright

Β© 2025 WinSnip Official. All Rights Reserved.

This project is licensed under MIT License with Additional Restrictions:

βœ… ALLOWED:

  • Use for personal, educational, or commercial purposes
  • Fork and modify the code
  • Distribute and sublicense

❌ PROHIBITED:

  • Remove or alter WinSnip branding, logos, or attribution
  • Claim this work as your own
  • Misrepresent the origin of this software

⚠️ REQUIRED:

  • Maintain copyright notice and license in all copies
  • Keep visible attribution to WinSnip in public deployments
  • Include "Built on Trusted Infrastructure" or similar attribution

For full license terms, see LICENSE file.

Violation of these terms may result in legal action and license revocation.

🀝 Contributing

We welcome contributions! Please read CONTRIBUTING.md first.

Quick steps:

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

πŸ“ž Support

πŸ’Ž Supported Chains

Mainnets (19 Chains)

Chain Logo Type Status
AtomOne Cosmos βœ… Active
Axone Cosmos βœ… Active
BitBadges Cosmos βœ… Active
CNHO Stables Cosmos βœ… Active
CosmosHub Cosmos βœ… Active
Gitopia Cosmos βœ… Active
Humans.ai Cosmos βœ… Active
Lava Network Cosmos βœ… Active
Lumera Cosmos βœ… Active
Noble Cosmos βœ… Active
Osmosis Cosmos βœ… Active
Paxi Network Cosmos βœ… Active
Shido Cosmos+EVM ⚑ βœ… Active
Sunrise Cosmos βœ… Active
Tellor Cosmos βœ… Active
Uptick Network Cosmos+EVM ⚑ βœ… Active
Warden Protocol Cosmos+EVM ⚑ βœ… Active
XRPL EVM Sidechain Cosmos+EVM ⚑ βœ… Active
Zenrock Cosmos βœ… Active

Testnets (11 Chains)

Chain Logo Network
AtomOne Testnet
CosmosHub Testnet
Empeiria Testnet
Kiichain Testnet
Lumera Testnet
Noble Testnet
Osmosis Testnet
Safrochain Testnet
Warden Barra Testnet
XRPL EVM Testnet
Zenrock Testnet

⚑ EVM Compatible Chains: Shido, Uptick Network, Warden Protocol, XRPL EVM Sidechain support both Cosmos and EVM transactions with WebSocket real-time updates

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


Made with ❀️ by WinSnip

⭐ Star this repo if you find it useful!

Website Twitter Telegram

About

πŸ” Professional Multi-Chain Blockchain Explorer for Cosmos Ecosystem

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6

Languages