Wallet Warden

Wallet Warden - Ethereum Address Security & Reputation Analysis

Built for ETH Prague 2024, Wallet Warden is a platform created for users' security that evaluates Ethereum wallet reputation through blockchain analysis (transactions, contract interactions, suspicious transaction patterns). The application integrates with Blockscout's APIs to provide real-time insights into wallet behavior, transaction patterns, and potential security risks.

Core Features: Reputation scoring analyzing 40+ wallet metrics including transaction frequency, balance stability, DeFi interactions, and contract usage patterns Advanced risk detection identifying suspicious activities like Tornado Cash interactions, bot-like behavior (suspicious patterns), dust attacks, and excessive daily transactions.

Portfolio analytics with token diversity scoring, blue-chip asset recognition, and liquidity analysis Interactive visualizations showing transaction timelines, balance history, and portfolio distribution using Chart.js

Security assessment with verified contract interaction bonuses and unverified contract penalties Technical Implementation: The platform leverages 8 distinct Blockscout REST API endpoints for comprehensive data gathering: wallet information, transaction history, token holdings, internal transactions, token transfers, balance history, address counters, and transaction details. Data processing includes parallel API calls with Promise.allSettled for fault tolerance, sophisticated error handling, and comprehensive data validation.

The reputation algorithm weighs factors like balance volatility, transaction consistency, portfolio diversification, contract interaction depth, and network participation to generate scores from 0-100. Risk flags are automatically generated for interactions with known risky contracts, unusual transaction patterns, or suspicious wallet behaviors.

Hackathon Integration: Built specifically to showcase Blockscout's API capabilities, demonstrating advanced blockchain data analysis beyond basic explorer functionality. The application processes real-time Ethereum data to provide actionable security insights for DeFi users, traders, and security researchers.

The Stack Built with React 18 and Vite. Used Chart.js for the charts, and Ethers.js for Web3 interaction.

Blockscout Integration We use 8 different Blockscout REST endpoints simultaneously to retrieve data used ti analyse the reputation.

The Reputation Algorithm The scoring system processes transaction patterns, portfolio diversity, contract interactions, balance stability, and risk factors. It's weighted:

25% transaction consistency 20% portfolio diversity 20% contract sophistication 20% balance stability 15% risk assessment

Hacky Solutions That Work Address Chaos: Blockscout returns addresses in random cases, so we just lowercase everything.

Wei Conversion: When Ethers.js fails on malformed values, we catch the error and do the math manually.

Data Validation: We validate everything in layers because API responses can't be trusted.

Performance Stuff We fire 8 API requests simultaneously instead of sequentially - gets results in 2-3 seconds instead of 8-10. Each endpoint has its own error handling so if one fails, the analysis continues.

Security Detection We maintain a list of risky contracts (Tornado Cash, mixers, etc.) and reputation points for interactions. Bot detection looks for excessive daily transactions, identical values, and micro-transaction spam.

Frontend Simple React components with CSS Grid for responsive layout. Chart.js integration required converting Blockscout timestamps to readable formats.

Why It Matters This shows what you can build beyond basic explorer usage. 8 REST endpoints, sophisticated analysis, and a tool that's actually useful for assessing wallet credibility in DeFi interactions.