Skip to content

gyoomei/mimo-wallet-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🦊 MiMo Wallet Tracker

Unified Multi-Chain EVM Wallet Intelligence Dashboard β€” 100% Client-Side, No API Key, No Backend

πŸ”— Live: https://gyoomei.github.io/mimo-wallet-tracker/


What Is This?

MiMo Wallet Tracker is a zero-infrastructure dashboard for monitoring EVM wallets across 15 blockchains simultaneously in a single unified view. Paste any wallet address β†’ auto-scan all chains β†’ display balances, tokens, transactions, and AI-powered risk analysis.

No API keys. No backend. No registration. No cost.

The Problem It Solves

Existing wallet trackers typically:

  • Require API keys (Etherscan, Alchemy, Infura)
  • Support only 1–2 chains per view
  • Need backend servers or database
  • Charge for real-time data

MiMo Wallet Tracker solves all of this by leveraging the Blockscout V2 API β€” a free, open-source blockchain explorer API with CORS support, allowing direct browser-to-API calls without any proxy or backend.

Features

πŸ”— Unified Multi-Chain View

One wallet = one entry, tracking all 15 chains simultaneously. A color-coded chain grid shows balance per chain. Chains with holdings are highlighted green. A proportional bar visualizes portfolio distribution.

15 Supported Chains: Ethereum Β· Base Β· Arbitrum Β· Polygon Β· zkSync Β· Scroll Β· Celo Β· Arbitrum Nova Β· Filecoin Β· Mode Β· Zora Β· Unichain Β· Soneium Β· Redstone Β· Degen

πŸ’° Real-Time Balance & Token Tracking

  • Native coin balance (ETH, POL, CELO, FIL, DEGEN, etc.)
  • ERC-20 token holdings grouped by chain
  • USD value with live ETH price from Blockscout
  • Chain proportion bar (visual portfolio breakdown)

πŸ“‹ Transaction History

  • Transactions from all chains, sorted by time
  • Method decoding: transfer, swap, approve, mint, contract interaction
  • Status indicators (success / failed / pending)
  • Direction tracking (inbound / outbound)
  • Per-transaction chain badge

🧠 AI-Powered Risk Analysis (Client-Side)

  • Pattern detection: failed transactions, large transfers, token approvals
  • Risk scoring: LOW β†’ MEDIUM β†’ HIGH β†’ CRITICAL
  • Automated recommendations (e.g. "Review approvals at revoke.cash")
  • Chain-by-chain activity breakdown

πŸ”” Smart Alerts

  • Auto-detect large transfers (>1 ETH outbound)
  • Failed transaction warnings
  • Token approval notifications
  • Alert history with severity levels (info / warning / critical)

⚑ Zero Infrastructure

  • Pure HTML / CSS / JS β€” no build step, no framework, no dependencies
  • Single file deployment (941 lines)
  • GitHub Pages compatible
  • localStorage persistence (wallets survive page refresh)
  • Auto-refresh every 3 minutes

Architecture

Browser (100% client-side)
β”œβ”€β”€ Wallet Input β†’ Validate 0x address
β”œβ”€β”€ Chain Scanner (parallel batches of 5)
β”‚   β”œβ”€β”€ Blockscout API β†’ /addresses/{addr}        (balance + metadata)
β”‚   β”œβ”€β”€ Blockscout API β†’ /addresses/{addr}/transactions  (tx history)
β”‚   └── Blockscout API β†’ /addresses/{addr}/tokens        (ERC-20 holdings)
β”œβ”€β”€ Risk Analyzer β†’ pattern detection + scoring
β”œβ”€β”€ Alert System  β†’ anomaly detection
└── localStorage  β†’ wallet persistence

There is no backend. All logic runs in the user's browser. API calls go directly to Blockscout public endpoints.

Tech Stack

Component Technology
Frontend Vanilla HTML / CSS / JS (single file)
API Blockscout V2 (free, no key, CORS *)
Fonts Inter + JetBrains Mono (Google Fonts)
Hosting GitHub Pages (static)
Storage localStorage
Fetch Native fetch + AbortController (8s timeout)
Error Handling Promise.allSettled + try/catch

Key Design Decisions

  1. Blockscout over Etherscan β€” Free, CORS-enabled, no rate limit registration, 18+ chains
  2. Single file over framework β€” Zero dependencies, instant deploy, easy to fork
  3. Client-side analysis over server β€” Privacy-first, no data leaves the browser
  4. Parallel batch scanning (5 chains) β€” Balance between speed and reliability
  5. AbortController timeout β€” Prevents one slow chain from hanging the entire scan
  6. Promise.allSettled β€” One chain failing doesn't block the others

Use Cases

  • DeFi users β€” Monitor portfolio across L1 + L2 chains
  • NFT collectors β€” Track mints and holdings multi-chain
  • Security researchers β€” Analyze wallet activity patterns
  • Whale watchers β€” Monitor large wallets (Vitalik, etc.)
  • Builders β€” Fork and customize for your own needs

Quick Start

  1. Open https://gyoomei.github.io/mimo-wallet-tracker/
  2. Paste a wallet address (0x...)
  3. Click "+ Add"
  4. Wait for scanning (~15 seconds)
  5. Click a wallet card to view details (transactions, tokens, analysis)

Stats

Metric Value
Code 941 lines, single HTML file
Chains 15 EVM networks
API Keys 0
Backend 0
Dependencies 0
Cost $0 (fully free tier)
Scan Time ~15s per wallet (all chains)

API Reference

Uses Blockscout API v2 β€” completely free, no registration needed.

Endpoints used:

  • GET /api/v2/addresses/{address} β€” Balance, exchange rate, activity flags
  • GET /api/v2/addresses/{address}/transactions β€” Transaction history
  • GET /api/v2/addresses/{address}/tokens β€” ERC-20 token holdings
  • GET /api/v2/stats β€” Network stats + ETH price

License

MIT β€” Fork it, ship it, make it yours.


Built with 🦊 by gyoomei

About

🦊 Unified Multi-Chain EVM Wallet Intelligence Dashboard β€” 15 chains, no API key, no backend, 100% client-side

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors