EtherFlow is a comprehensive web application for analyzing Ethereum transaction patterns and relationships. It provides powerful tools to visualize, analyze, and understand ETH transfer networks between addresses, featuring multiple visualization modes, advanced analytics, and anomaly detection.
Note: This project was generated with Claude Code as a learning project to demonstrate AI-assisted software development.
- Address Search: Analyze any Ethereum address for transfer patterns with EOAs (Externally Owned Accounts)
- Transfer Mapping: View complete transfer relationships showing sent/received amounts
- Time Filtering: Filter analysis by specific block ranges for targeted investigation
- Anomaly Detection: Automatically identify unusual transaction patterns and suspicious activity
- Saved Searches: Manage search history with custom names and restore previous analyses
- JSON Export: Export complete transfer data for external analysis
- Search History: Quick access to recent searches and saved analysis sessions
- Standard Network Graph: Interactive D3.js-powered node-link visualization showing address relationships
- Timeline Visualization: Chronological view of transactions over time with filtering capabilities
- Transaction Volume Heatmap: Time-based patterns showing transaction density and volume
- Tree Map Visualization: Hierarchical representation of transaction volumes and relationships
- Pattern Analysis: Automated detection of periodic transfers, round number patterns, and distribution behaviors
- Gas Usage Analysis: Comprehensive gas spending analysis with optimization recommendations
- Profit/Loss Analysis: Track net gains/losses and value flow over time
- Wallet Behavior Profiling: Categorize addresses by behavior patterns (trader, holder, distributor, etc.)
- Risk Assessment: Calculate risk scores based on transaction patterns and anomalies
- Frontend: React.js with modern hooks and state management
- Blockchain Data: Alchemy SDK for reliable Ethereum network access
- Visualizations: D3.js for interactive charts and network graphs
- Styling: Tailwind CSS with custom shadcn/ui-inspired components
- Analytics: Custom services for pattern analysis, gas optimization, and profit/loss tracking
- Node.js (v14 or later)
- npm or yarn
- Alchemy API key
-
Clone the repository
git clone https://github.com/yourusername/etherflow.git cd etherflow -
Install dependencies
npm install
-
Create a
.envfile in the root directory and add your Alchemy API key:REACT_APP_ALCHEMY_API_KEY=your-api-key-here
-
Start the development server
npm start
-
Open http://localhost:3000 in your browser
- Setup: The app automatically detects your Alchemy API key from environment variables
- Search: Enter any valid Ethereum address (0x format) in the search box
- Filter: Optionally enable time-based filtering using block numbers for targeted analysis
- Analyze: View the complete list of transfer partners with sent/received amounts
Switch between different visualization modes to explore your data:
- Standard Network: Interactive graph showing address relationships
- Timeline View: Chronological transaction history with time-based insights
- Volume Heatmap: Visual patterns of transaction density over time
- Tree Map: Hierarchical view of transaction volumes
Access powerful analysis tools:
- Pattern Analysis: Detect periodic transfers, distribution patterns, and anomalies
- Gas Analysis: Examine gas usage patterns and get optimization recommendations
- Profit/Loss Analysis: Track net value flow and portfolio performance over time
- Save Searches: Create named bookmarks for important addresses
- Export Data: Download complete transfer data as JSON for external analysis
- Quick Access: Use search history for rapid re-analysis of previous queries
To use this application, you'll need an Alchemy API key:
- Sign up for a free account at Alchemy
- Create a new application in the Alchemy dashboard
- Select the Ethereum network you want to use
- Copy your API key and use it in the application
EtherFlow can be easily deployed to Vercel or other static hosting platforms. See DEPLOYMENT.md for detailed instructions.
Important: Since this is a client-side app, the API key will be visible to users. Use a free-tier Alchemy key and configure domain restrictions in your Alchemy dashboard for security.
EtherFlow is built with a modular architecture for maintainability and extensibility:
- Core App: Main application logic and state management in
src/App.js - UI Components: Reusable shadcn/ui-inspired components in
src/components/ui/ - Analysis Components: Specialized components for different analytics in
src/components/ - Services: Business logic and external API integration in
src/services/
- alchemyService.js: Ethereum blockchain data fetching and processing
- patternAnalysisService.js: Transaction pattern detection and wallet profiling
- gasAnalysisService.js: Gas usage analysis and optimization recommendations
- profitLossService.js: Portfolio performance and value flow tracking
- treeMapService.js: Hierarchical data processing for tree map visualizations
Chronological visualization reveals transaction patterns over time:
- Interactive timeline with transaction points plotted by timestamp
- Identify periods of high/low activity and behavioral changes
- Hover interactions show detailed transaction information
- Time period filtering for focused analysis
Automated detection of common transaction behaviors:
- Periodic Transfers: Regular/scheduled payment patterns
- Round Numbers: Preference for round transaction amounts
- Distribution Patterns: Single source to multiple destinations
- Collection Patterns: Multiple sources to single destination
- Large Transfer Detection: Transactions significantly above average amounts
Comprehensive analysis of transaction costs and efficiency:
- Gas price trends and optimization opportunities
- Transaction complexity analysis based on gas usage
- Cost efficiency recommendations for future transactions
- Comparative analysis against network averages
Portfolio performance analysis over time:
- Net value flow calculations (inbound vs outbound)
- Time-based P&L tracking with visual charts
- ROI analysis for trading addresses
- Value flow visualization between address relationships
MIT
This project was built with the assistance of Claude Code, Anthropic's AI coding assistant. It demonstrates how AI-assisted development can rapidly implement complex visualizations and data analysis tools. The project serves as a learning resource for blockchain data analysis and AI-assisted software development.
EtherFlow is valuable for various Ethereum analysis scenarios:
- Fraud Investigation: Detect suspicious patterns and trace fund flows
- Compliance Analysis: Monitor address behavior for regulatory compliance
- Risk Assessment: Evaluate counterparty risk based on transaction patterns
- Portfolio Analysis: Track performance and value flows across addresses
- Due Diligence: Research addresses before engaging in transactions
- Market Research: Understand trading patterns and behaviors
- Behavioral Analysis: Study transaction patterns and wallet behaviors
- Network Analysis: Understand Ethereum transaction network topology
- Gas Optimization: Research efficient transaction strategies
Current Version: Fully functional with all core features implemented
- ✅ Complete transfer analysis and visualization suite
- ✅ Advanced pattern recognition and anomaly detection
- ✅ Multi-mode visualizations (Network, Timeline, Heatmap, TreeMap)
- ✅ Comprehensive analytics (Pattern, Gas, Profit/Loss analysis)
- ✅ Search management and data export capabilities
For future enhancements and feature requests, see ENHANCEMENT_IDEAS.md.