​

Whale Watcher

Whale Watcher is a supporting signal surface for Stablecoin Vault readiness. It focuses on large stablecoin and treasury-like wallet monitoring, assembling multiple analytical layers for a single wallet address into one view — activity history, behavioral signals, AI-assisted narratives, token holdings, and protocol usage patterns — so the movement of significant wallets can be carried into a vault-readiness review. It is a read-only intelligence surface: no custody, no wallet keys, no account required.

​

Homepage signal feed

The homepage includes an illustrative Whale Watcher signal feed. It animates sample on-chain alert rows and links into the Whale Watcher route when a row is selected. The feed is a product-navigation preview, not a live provider stream and not a Dune query result. It should be documented and described as illustrative sample activity only. The full workspace remains the source-backed surface: scheduled Dune activity, live wallet provider samples, deterministic signals, and source/caveat badges are rendered after a wallet is opened.

​

Workspace layout

The workspace is organized into vertical sections, top to bottom:

​

Data flow: activity data to narrative

Signals degrade gracefully when the baseline is null. AI narrative rewriting is optional and only active when a provider key is configured. See Signal Engine for the full taxonomy.

​

12-week activity heatmap

The heatmap visualizes per-day on-chain activity intensity over a 12-week rolling window. Each cell represents one day; color intensity corresponds to the intensity_score field from the Dune scheduled query. While Dune data loads, the activity section shows a skeleton heatmap grid with the label “Indexing scheduled wallet activity.” and a syncing badge. The full grid renders once the scheduled query response is available.

​

Adversarial signals

Adversarial signals are behavioral exposure heuristics derived from wallet transaction history and the 12-week Dune activity data. They are computed by the behavioral-signals engine. These are deterministic, explainable heuristics. They are not findings of wrongdoing and do not imply intent, identity, or legal status. Each signal carries:

• score (0.0–1.0)
• confidence — reflects data completeness, not accusatory certainty
• reason — observation language only (“resembles”, “may indicate”, “increases exposure”)
• evidence — the underlying on-chain data fields that produced the score

Signals with score < 0.3 are computed but not displayed. When no signal meets the rendering threshold, the UI shows a low-noise empty state.

​

Narrative engine

Narrative cards are produced by the narrative engine. The engine converts WalletSignal[] facts from the signal engine into structured NarrativeCard objects. The narrative engine is deterministic — it templates from signal evidence fields and never invents numbers, protocols, or chains. An optional AI layer may rewrite the prose but must leave evidence values unchanged. Each narrative card shows:

• Headline (≤120 characters, derived from primary signal evidence)
• Body and key points
• Data source badges with freshness information
• Confidence level and caveats

​

Wallet Holdings Strip

The Wallet Holdings Strip displays the wallet’s token portfolio — either as balance-denominated positions or as trading exposure — depending on the Dune query shape configured. Two query shapes are supported automatically:

​

Protocol Affinity Bar

The Protocol Affinity Bar shows the fraction of the wallet’s on-chain volume that flowed through each DeFi protocol (Uniswap, Aave, Curve, etc.). It is derived from the baseline and live event data assembled by the signal engine.

​

Quantum section

The Quantum Exposure section in Whale Watcher renders two cards stacked vertically:

• Quantum Exposure Card — composite score ring, per-component breakdown, behavioral signals, source caveats, and the policy simulator.
• Quantum Vault Readiness Card — recovery readiness signals, dormancy feed findings, and the Migration Path panel. The migration path is derived at render time by the migration-readiness recommender using the wallet’s exposure score, value at risk, dormancy, and wallet structure. It recommends one of: monitor, fresh-wallet, split-wallet, multisig, treasury-custody, or vault-prototype. When vault-prototype is recommended, the panel surfaces a vault candidate row and the WalletWall Vault research disclosure automatically.

See Quantum Intelligence for the full score specification, migration path table, and approved framing.

​

Signal engine dependency

Whale Watcher depends on the signal engine to produce WalletSignal[] facts before narratives and the Protocol Affinity Bar can be rendered. The signal engine requires:

• A HistoricalWalletBaseline from the Dune scheduled query (may be null — signals degrade gracefully)
• Live wallet events from Alchemy or Etherscan

See Signal Engine for the full taxonomy and confidence rules.

​

Related