https://github.com/dvisacker/ethereum-inspector
A command-line tool for in-depth analysis of ethereum/evm addresses.
https://github.com/dvisacker/ethereum-inspector
blockchain ethereum evm
Last synced: 10 months ago
JSON representation
A command-line tool for in-depth analysis of ethereum/evm addresses.
- Host: GitHub
- URL: https://github.com/dvisacker/ethereum-inspector
- Owner: Dvisacker
- Created: 2025-05-12T04:21:30.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-07-09T16:55:00.000Z (12 months ago)
- Last Synced: 2025-07-10T01:33:11.077Z (12 months ago)
- Topics: blockchain, ethereum, evm
- Language: TypeScript
- Homepage:
- Size: 27.4 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
#
🔍 Ethereum Inspector
[](https://github.com/david/wallet-inspector)
[](https://github.com/david/wallet-inspector/blob/main/LICENSE)
[](https://nodejs.org)
A command-line tool for in-depth analysis of Ethereum addresses. Uncover transaction patterns, identify related wallets and download a spreadsheet with the results. Work in progress.
## 📝 Example Results
View an [example analysis](https://docs.google.com/spreadsheets/d/1RuktzgHN5rJWhF7w5q6023j-Xv3DJi71FkExS24kxeM/edit?usp=sharing) of Abraxas (an Italian crypto fund).
## 📊 Features
- **Timing Analysis**
- Busiest periods and work/sleep windows
- Timezone inference
- Transaction distribution patterns
- **Related Wallets**
- Detection of connected addresses
- Arkham entity/label integration
- Scam transaction filtering (WIP)
- **Contract Interactions**
- Most frequently interacted contracts
- Contract metadata and proxy information
- **Transfer Analysis**
- ETH and token transfers
- Transfer patterns and volumes
- **Excel Export**
- XLSX export
- Color-coded tables
- **Data Integration**
- Etherscan for contract verification
- Arkham for entity data
- HyperSync for efficient blockchain queries
- **Bridge Transactions (alpha)**
- Bridge transactions from CCTP, LayerZero, Relay, etc.
## 🚀 Getting Started
### Prerequisites
- Node.js >= 16.0.0
- npm or yarn
### Installation
1. Clone the repository:
```bash
git clone https://github.com/david/wallet-inspector.git
cd wallet-inspector
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables:
```bash
cp .env.example .env
```
Configure the following in your `.env` file:
```env
ETHERSCAN_API_KEY=your_etherscan_api_key
ALCHEMY_API_KEY=your_alchemy_api_key
ARKHAM_COOKIE=your_arkham_cookie
```
4. Run the tool:
```bash
npm run dev
```
## 🔧 Configuration
### API Keys
- **Etherscan**: Required for contract verification
- **Alchemy**: Required for blockchain data access
- **Arkham**: Required for entity data (cookie can be found in browser developer tools)
## 🛠️ Development
### Project Structure
```
wallet-inspector/
├── src/
│ ├── analysis/ # Analysis logic
│ ├── formatters/ # Output formatting
│ └── utils/ # Utility functions
├── scripts/ # Build and utility scripts
└── tests/ # Test files
```
### Available Scripts
- `npm run dev`: Start development mode
- `npm run build`: Build the project
- `npm test`: Run tests
- `npm run lint`: Run linter
## 📋 Roadmap
### Optimizations
- [ ] Batch HyperSync queries
- [ ] Implement caching layer for external APIs
- [ ] Optimize analysis for high-transaction wallets
- [ ] Cache analysis options
### New Features
- [ ] Wallet similarity analysis
- [ ] Net inflow/outflow tracking
- [ ] Embedded database for labels
- [ ] PDF export
- [ ] Contract function analysis
- [ ] Multi-chain support
- [ ] Bridge transaction tracking
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.