A modern, privacy-focused Zcash blockchain explorer with AI-powered assistance
Features • Quick Start • Architecture • Connected Projects • Documentation
Zcash Explorer is a comprehensive blockchain explorer built specifically for the Zcash ecosystem. It provides real-time insights into the Zcash blockchain with a focus on privacy features, shielded transactions, and user experience.
- 🔐 Privacy-First Design: Full support for shielded transaction decryption and wallet scanning
- 🤖 AI-Powered: Integrated ElizaOS agent for intelligent Zcash assistance
- ⚡ Real-Time Updates: Live blockchain stats with 10-second auto-refresh
- 📊 Comprehensive Analytics: Detailed block, transaction, and network statistics
- 🎨 Modern UI: Clean, responsive design with dark/light theme support
- 💰 Market Integration: Live price charts and market data powered by CoinGecko, getblock RPC
This explorer aggregates data from multiple sources to provide comprehensive blockchain insights:
Primary data source using standard JSON-RPC methods:
getblockchaininfo- Chain state and verification statusgetbestblockhash- Latest block informationgetblockhash- Block lookup by heightgetblock- Detailed block data with transactionsgetrawtransaction- Transaction detailsgetnetworkhashps- Network hashrategetchaintxstats- Transaction statistics
Supported RPC Providers:
- GetBlock.io (recommended for quick setup)
- Self-hosted
zcashdnode - Other Zcash RPC providers
- CoinGecko API: Real-time ZEC price, market cap, volume, and 30-day price history
- Automatic fallback and rate limiting
- Cached responses for optimal performance
This explorer integrates with multiple specialized services to provide enhanced functionality:
Purpose: Decrypt shielded Zcash transactions using Unified Full Viewing Keys (UFVK)
Repository: zcashShieldedTxDecryption Repository: zcashblockdecryption
Features:
- ✅ Decrypt Sapling and Orchard shielded outputs
- ✅ Extract transaction memos
- ✅ Scan wallet by block range, last 1 hour, or wallet birthday
- ✅ Privacy-focused (UFVK never stored)
- ✅ Support for up to 100 blocks per scan
Purpose: AI-powered assistant for Zcash-related questions
Repository: zcashagent103
Technology: ElizaOS (AI agent framework)
Features:
- ✅ Answer questions about Zcash protocol
- ✅ Explain shielded transactions and privacy features
- ✅ Provide blockchain data insights
- ✅ Context-aware responses
- ✅ Typing indicators and connection status
Purpose: Hosted Zcash node RPC access
Purpose: Zcash market data and price information
┌─────────────────┐
│ Zcash Explorer │
│ (Next.js) │
└────────┬────────┘
│
├─────────────────┐
│ │
v v
┌──────────┐ ┌──────────────┐
│ GetBlock │ │ CoinGecko │
│ RPC │ │ API │
└──────────┘ └──────────────┘
│
v
┌─────────────────────────────┐
│ Blockchain Data (Blocks, │
│ Transactions, Network Info)│
└─────────────────────────────┘
│
├──────────────┐
│ │
v v
┌─────────────┐ ┌──────────────┐
│ Decryption │ │ AI Agent │
│ Services │ │ (ElizaOS) │
└─────────────┘ └──────────────┘
│ │
v v
┌─────────────┐ ┌──────────────┐
│ Shielded │ │ Q&A Chat │
│ Tx Data │ │ Interface │
└─────────────┘ └──────────────┘
- Node.js ≥ 18
- npm or pnpm
- A Zcash RPC endpoint URL (e.g. from GetBlock or your own
zcashdnode)
- Clone the repository:
git clone https://github.com/Len3hq/zcash-explorer.git
cd zcash-explorer- Install dependencies:
npm install
# or
pnpm install- Configure environment variables:
Create a .env.local file in the project root:
# ============================================
# Zcash RPC Configuration
# ============================================
# Required: Primary Zcash RPC endpoint
ZCASH_RPC_URL=https://go.getblock.io/YOUR_API_KEY
# ============================================
# Decryption Services (Optional)
# ============================================
# Single transaction decryption
ZCASH_DECRYPT_API_URL=
# Wallet scanner (batch block decryption)
ZCASH_SCANNER_API_URL=
# ============================================
# ElizaOS Agent (Optional)
# ============================================
NEXT_PUBLIC_ELIZA_SOCKET_URL=
NEXT_PUBLIC_ELIZA_AGENT_ID=
# ============================================
# Server Configuration
# ============================================
PORT=3002Development mode (with hot reload):
npm run devProduction build:
npm run build
npm startAccess the explorer:
- Local:
http://localhost:3002 - Production: Your deployed URL
Comprehensive guides and references:
- QUICKSTART.md - Quick start guide for AI agent setup
- AGENT_INTEGRATION_GUIDE.md - Detailed agent integration documentation
- INTEGRATION_SUMMARY.md - Technical implementation summary
- WALLET_SCAN_INTEGRATION.md - Wallet scanning feature guide
- Next.js 14 - React framework with App Router and Server Components
- TypeScript - Type-safe development
- React 18 - UI library with Server Components
- Chart.js - Interactive price charts
- date-fns - Date formatting and manipulation
- CSS Variables - Custom theme system with dark/light modes
- Socket.IO Client - Real-time bidirectional communication
- Next.js API Routes - Serverless API endpoints
- Zcash JSON-RPC - Direct blockchain data access
- CoinGecko API - Cryptocurrency market data
- ElizaOS - AI agent framework
- Railway - Cloud deployment platform
- GetBlock.io - Hosted Zcash RPC nodes
- PostgreSQL - Caching database for scanner service
We welcome contributions! Here's how you can help:
- Check existing issues before creating new ones
- Provide detailed reproduction steps
- Include screenshots for UI issues
- Specify your environment (OS, browser, Node version)
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ by:
- Twitter: @len3_x
- Zcash Foundation: z.cash
- Zcash Documentation: zcash.readthedocs.io
If you find this explorer useful, please consider:
- ⭐ Starring the repository
- 📢 Sharing with the Zcash community
- 💰 Supporting via the "Support Our Work" button in the footer
Made with privacy and transparency in mind 🔐