A web-based blockchain explorer for the Accumulate protocol, providing real-time network monitoring, transaction tracking, and account inspection across multiple Accumulate networks.
🤖 For AI Assistants: See AI-README.md for quick reference on deployment, architecture, and common tasks.
- Mainnet - Production Accumulate network
- Kermit Testnet - Primary test network with ETH endpoint support
- Fozzie Testnet - Secondary test network
- Local Devnet - Local development blockchain
- Account Explorer - View account details, balances, and transaction history
- Transaction Tracking - Search and inspect transactions with signature details
- Block Explorer - Browse major and minor blocks with full chain data
- Network Health Monitoring - Real-time network status with partition synchronization checks
- Search - Search by account URL, transaction ID, public key, or key hash
- Web3 Wallet Integration - Connect via MetaMask or WalletConnect
Visual status indicators show real-time network health:
- 🟢 Green - All partitions synchronized and healthy
- 🟡 Yellow - Network experiencing synchronization delays
- ⚪ Gray - Loading or checking network status
Health checks validate:
- CORS configuration (browser compatibility)
- Partition synchronization (< 10 blocks lag)
- Anchor ledger synchronization
- Synthetic message ledger synchronization
- Data freshness (< 60 seconds old)
The Explorer includes a production-ready Model Context Protocol (MCP) server that enables AI assistants to interact with Accumulate networks.
- Devnet Management - Start/stop local Accumulate blockchain
- Explorer Control - Launch web interface for any network
- Network Queries - Query accounts, transactions, blocks, and chains
- Health Checks - Comprehensive network validation matching browser behavior
- Network Switching - Connect to mainnet, testnets, or custom endpoints
- MCP README - Complete usage guide with examples
- MCP Implementation - Technical details and architecture
- Health Check Investigation - CORS validation details
- Node.js 20+
- npm 10+
# Install dependencies
npm install
# Start development server
npm start
# Open browser to http://localhost:5173# Create optimized production build
npm run build
# Build output will be in build/ directory
# Deploy build/ contents to your web serverThe explorer automatically detects the network based on hostname:
kermit.explorer.accumulatenetwork.io→ Kermit Testnetfozzie.explorer.accumulatenetwork.io→ Fozzie Testnetlocalhost→ Local Devnet (or last selected network)- Other domains → Mainnet (or last selected network)
Network switching is enabled when VITE_NETWORK=any environment variable is set.
npm start # Start dev server with hot reload
npm run build # Build for production
npm run check # Run TypeScript type checking
npm run format # Format code with Prettier
npm run preview # Build and preview production buildsrc/
├── components/
│ ├── common/
│ │ ├── Network.tsx # Network context and health checks
│ │ └── networks.tsx # Network configurations
│ ├── explorer/ # Explorer UI components
│ ├── views/ # Page views
│ └── web3/ # Web3 wallet integration
├── utils/ # Utility functions
├── sdk-patches.ts # SDK compatibility patches
├── index.tsx # App entry point
└── App.tsx # Main app component
mcp/
├── src/
│ └── index.ts # MCP server implementation
├── README.md # MCP usage guide
├── IMPLEMENTATION.md # Technical documentation
└── test-*.js # Health check tests
- Visual Indicator: Maroon top bar (#4B0000)
- Default Port: 26660
- ETH Endpoint: http://127.0.0.1:26660/eth
- Visual Indicator: Dark purple top bar (#2D1640)
- Kermit ETH Support: https://kermit.accumulatenetwork.io/eth
- Metrics Dashboard: https://metrics.accumulatenetwork.io/v1
- Production Explorer: https://explorer.accumulatenetwork.io
Both production and beta are hosted on Netlify with auto-deployment:
Deploy to Beta:
git push github develop:updatesDeploy to Production:
git push github develop:mainNetlify automatically builds and deploys in ~2 minutes.
- Production: https://explorer.accumulatenetwork.io (GitHub
mainbranch) - Beta: https://beta.explorer.accumulatenetwork.io (GitHub
updatesbranch) - Build Config:
netlify.toml
See DEPLOYMENT.md for complete deployment documentation.
Comprehensive testing procedures are documented:
- TESTING.md - Testing strategy and checklists
- TEST-RESULTS.md - Test execution results
# Start dev server
npm start
# Open http://localhost:5173
# Verify:
# - Page loads without errors
# - Network dropdown appears
# - Can switch between networks
# - Health indicators show status dotsSupports modern browsers:
- Chrome/Edge (last 2 versions)
- Firefox (last 2 versions)
- Safari (last 2 versions)
Requires JavaScript enabled and CORS-compatible API endpoints.
- React 17 - UI framework
- TypeScript 5 - Type safety
- Vite 5 - Build tool and dev server
- Ant Design 4 - UI component library
- accumulate.js 0.11 - Accumulate protocol SDK
- ethers.js 6 - Ethereum wallet integration
- @web3modal/ethers 5 - WalletConnect integration
Non-blocking type errors in WalletConnect/MetaMask type declarations. Does not affect runtime.
Known vulnerabilities in axios (used by accumulate.js). Monitoring for SDK updates.
- TypeScript strict mode
- Prettier formatting (configured in package.json)
- Imports sorted automatically
# Format code
npm run format
# Check types
npm run checkSee LICENSE file for details.
- Repository: gitlab.com/AccumulateNetwork/explorer
- Issues: Report bugs via GitLab issues
- Documentation: See docs in mcp/ directory
Current Version: 0.1.0
Recent improvements:
- ✅ Network switching with automatic cache validation
- ✅ MCP server for AI assistant integration
- ✅ Enhanced network health monitoring with CORS validation
- ✅ Web3 wallet integration (MetaMask, WalletConnect)
- ✅ Network-specific UI colors
- ✅ ETH endpoint support for Kermit and local devnets
Built with ❤️ for the Accumulate community