Holder Wall
Holder Wall is the ownership map and holder analytics surface of WalletWall. It displays the top holders of a selected token as a zoomable treemap, annotated with rank deltas, wallet labels, and an interactive drawer for per-wallet detail. Data is powered by Dune Analytics scheduled queries. It is never live streaming.KPI strip
A strip at the top of the page surfaces aggregate metrics for the current token: total holders tracked, number of wallets new this week, and the timestamp of the most recent Dune query run. The KPI strip reads from themetadata block of the /api/holder-wall response.
Treemap layout
Each tile in the treemap represents one holder. Tile area is proportional to the wallet’s balance in USD at the time of the last Dune run.Tabs
- Active Wallets — wallets included in the 48-hour active wallet feed
- Whale Wallets — wallets included in the whale trades feed
Rank badges
Each tile carries a rank badge showing absolute rank (1, 2, 3 …) and a delta indicator comparing the wallet’s rank in the current snapshot to the previous Redis snapshot. The rank snapshot is written to Redis on each successful Dune result fetch and compared on the next fetch. Rank delta is a derived field — it is not stored in Dune.Tile click
Clicking a tile opens the wallet drawer for that address. It also enables navigation to Coinstellation for a full graph view of the wallet’s on-chain relationships.Leaderboard
The leaderboard panel lists the top holders in rank order with holder labels, balances, and rank delta indicators. The “New this week” marker appears on wallets that were not present in the previous Redis snapshot.“New this week” is a Redis-derived signal. It reflects wallets that entered the tracked set since the last snapshot write, not wallets that created their Ethereum account this week.
Filters
The filter bar allows narrowing by wallet category (whale, active, dormant) and by rank range. Filters operate client-side against the current Dune result set.Wallet drawer
Clicking any tile or leaderboard row opens a slide-in drawer with per-wallet detail:- Resolved ENS name (when available)
- Balance and rank
- First seen / last active timestamps
- Link to open Coinstellation for this wallet
- Quantum Exposure Card (see below)
Quantum Exposure Card in the drawer
TheQuantumExposureCard component renders inside the drawer under the “Quantum Intelligence” heading. It shows:
- Composite Quantum Exposure Score (0–100)
- Risk band label: Low exposure / Moderate exposure / High exposure / Migration priority / Unknown
- Per-component breakdown: public key exposure, address reuse, signature scheme, value at risk, dormancy, migration readiness risk, recovery path risk
- Behavioral exposure signals (adversarial signals) — only signals with
score >= 0.3are rendered - Source caveats and confidence level
Data source aliases
| Public alias | Used for |
|---|---|
| Active wallet feed | Active Wallets tab — 48-hour active wallet feed |
| Whale trade feed | Whale Wallets tab — whale trade feed |
| Dormancy exposure feed | Dormancy-weighted quantum exposure signals (optional) |
| Redis snapshot store | Rank delta snapshots and “New this week” detection |
Scheduled/Cached in the UI. The queryRunAt timestamp is shown in the KPI strip.