Skip to content

DavidAlphaFox/deeplens

 
 

Repository files navigation


DeepLens

DeepLens

EVM On-Chain Intelligence

简体中文

Release   License   Build   Platform


DeepLens Dashboard


DeepLens is a desktop blockchain analytics application built for EVM networks. It connects directly to RPC nodes on Ethereum, Polygon, Arbitrum, Optimism, Base, BSC, and Avalanche, streaming blocks in real time and running analysis locally.

All investigation data, address labels, entity mappings, watched addresses, and alert history are stored in a local SQLite database on your machine. No cloud dependency, no account, no subscription.

Built with Rust (Tauri v2) and React 19. Ships as a native app for macOS, Windows, and Linux.


Features

Real-Time Dashboard

The main dashboard streams live block data and breaks it down across six panels:

  • Whale Alert tracks large-value transactions as they happen, color-coded by size tier. Transactions are classified by type (native transfer, contract call, DEX swap, NFT, bridge). A dedicated mega-whale counter highlights moves above 100 ETH equivalent. The full feed is exportable to CSV.
  • Smart Money scores active addresses from 0 to 100 based on flow patterns, counterparty diversity, temporal entropy, and volume. Each address receives a behavioral classification: Accumulator, Distributor, Bot, Whale, and others.
  • Hot Contracts ranks the top 20 most-called contracts by call frequency, showing unique caller count and total value received.
  • Network Pulse displays gas tiers (standard, fast, instant), base fee and priority fee, block utilization percentage, and activity surge or drop signals.
  • Value Flow shows the top senders and receivers ranked by volume, with net flow calculation and percentage breakdowns.
  • Block Deep View provides per-block analysis: top transfers, gas fee distribution histogram (p25/p50/p75), and most active addresses.

The persistent top bar shows live block height, base fee in Gwei, transaction volume, native token price (via CoinGecko), data provider health status, and unread alert count.

Address Profiling

Clicking any address in the app opens a full profile page with six tabs:

  • Overview shows balance (native + USD), total received and sent, net flow, transaction count, token transfer count, first and last seen timestamps, applied labels, and watch status.
  • Transactions lists paginated transaction history with hash, from/to addresses, value, USD equivalent, gas fee, block number, timestamp, and type classification. Each row expands into a detail modal.
  • Token Transfers shows ERC-20 transfer history with token symbol, transfer amount, USD value, and counterparty address.
  • Path Analysis lets you run fund-path tracing directly from the address page. Choose forward, backward, or bidirectional tracing with configurable hop depth.
  • Flow Visualization renders an interactive directed graph of inflows and outflows. Nodes are sized by PageRank importance. The engine runs community detection via label propagation and identifies hubs through betweenness centrality.
  • PnL Tracking calculates FIFO cost basis for token holdings, showing realized and unrealized gains, average cost per token, and buy/sell transaction counts.

From the same page you can assign custom labels, write notes, add the address to your watchlist, and see entity badges if the address belongs to a known entity.

Entity Mapping

Most on-chain activity involves organizations operating dozens of addresses. DeepLens lets you group addresses into named entities with individual roles.

An entity like "Binance" can include hot wallets, cold storage, deposit addresses, withdrawal processors, and fee collectors. Each member carries a role tag and chain assignment. Entity badges propagate throughout the UI: in the whale feed, on address pages, in path analysis results, and in the smart money panel.

The entity detail page shows all-chain aggregate statistics, per-member transaction counts and volumes, and internal vs external transaction classification (IN / OUT / INT). An auto-clustering tool analyzes your existing address labels and suggests entity groupings that you can review and approve.

Fund-Path Tracing

The path analyzer traces how funds move between addresses through intermediate wallets. Set a starting address, pick a direction (forward, backward, or both), choose the depth (up to 3+ hops), and receive a list of scored paths.

Each path result includes:

  • Hop sequence with every intermediate address, transaction hash, transferred value, and timestamp
  • Role classification for each node: Source, Sink, Relay, Accumulator, Distributor, Exchange, Bridge, Mixer, or Hub
  • Composite path score broken into five components: value retention, temporal tightness, directness, label hit rate, and behavioral anomaly score
  • Behavioral flags for automated detection: rapid relay chains, coordinated movement, layering patterns, round-trip flows, value conservation, and mixer interaction

Click any hop in a result to continue tracing from that address. The interface is built for iterative investigation.

Token Analytics

For any ERC-20 token address, DeepLens provides:

  • Holder distribution analysis with Gini coefficient, Herfindahl-Hirschman Index (HHI), top 10 holder concentration percentage, and bucketed distribution histogram
  • Recent transfer feed showing token movements with counterparty addresses, amounts, and timestamps
  • Wallet PnL with FIFO cost basis calculation, realized and unrealized gain breakdown per token

Alerts & Watchlist

Define alert rules scoped to specific chains or addresses:

  • Alert types: whale transfer, large token transfer, DEX swap, smart money movement
  • Severity levels: critical, warning, info
  • Evidence payloads: every alert includes structured JSON explaining why it fired, with threshold values, actual values, and contributing factors

The alerts page includes filtering by type and severity, bulk mark-as-read, a trend chart showing alert frequency over 7/14/30 day windows, and CSV export for offline review.

Watched addresses are managed separately with per-address notes and cross-chain balance overview.

Cross-Chain Portfolio

Track the same wallet across all 7 supported chains. DeepLens aggregates native balances, token counts, and USD values per chain, then rolls them into a unified portfolio view.


Supported Chains

Ethereum · Polygon · Arbitrum · Optimism · Base · BSC · Avalanche


Quick Start

Prerequisites: Bun, Rust, Tauri v2 system deps

git clone https://github.com/alanisme/deeplens.git
cd deeplens
bun install
bun run tauri dev

Production build:

bun run tauri build
# Outputs .dmg / .msi / .deb / .AppImage in src-tauri/target/release/bundle/

Data Providers

Provider Key Required Notes
Ankr No Public endpoints, works out of the box
dRPC No Free tier, 210M CU/month
Alchemy Yes Best coverage and reliability

Switch providers per chain in Settings > Networks. Health checks run automatically on startup.


Contributing

PRs welcome. For anything non-trivial, open an issue first.

bun install && bun run tauri dev
bun run fmt:check && bun run lint

See CONTRIBUTING.md for project structure and guidelines.

License

Apache License 2.0


Built by Alan
If DeepLens saves you time, a star helps others find it.

About

🔍 EVM blockchain analytics, real-time monitoring, address profiling, entity mapping, fund-path tracing

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 53.2%
  • Rust 45.6%
  • Other 1.2%