> ## Documentation Index
> Fetch the complete documentation index at: https://docs.walletwall.org/llms.txt
> Use this file to discover all available pages before exploring further.

# What is WalletWall?

> WalletWall is a read-only vault-readiness platform powered by wallet intelligence — it turns public Ethereum data into exposure assessments and a migration-readiness path toward safer vault migration.

# What is WalletWall?

WalletWall is a **read-only vault-readiness platform powered by wallet intelligence**. Wallet intelligence is the front door — it turns read-only, public Ethereum data into a structured view of how exposed a wallet is. Vault readiness is the center of gravity — that view becomes a prioritized migration-readiness path that prepares exposed wallets for safer vault migration before funds move.

WalletWall never asks for a wallet connection, a signature, or a private key, and it does not take custody of assets. It is read-only intelligence and prioritization — not protection.

<Note>
  All analysis uses public, read-only on-chain data and scheduled analytics queries. No private keys, seed phrases, or wallet signatures are used anywhere in the stack.
</Note>

## Product overview

WalletWall assesses four kinds of wallet exposure and brings them into one workflow:

* **Quantum / signature exposure** — has the wallet's public key been revealed on-chain, how much value is at stake, and how feasible is migration to post-quantum signatures.
* **Stablecoin & asset concentration** — how concentrated a wallet's holdings are, including stablecoin exposure.
* **Dormancy & activity** — how long since the wallet last acted, which affects both risk and migration-readiness.
* **Whale & behavioral patterns** — deterministic, explainable activity signals such as extraction-style movement, counterparty concentration, and activity ramps.

These signals are normalized into shared **risk tiers** and a recommended **migration-readiness path** — the read-only input the Stablecoin Vault readiness journey acts on — then packaged into a **Wallet Risk Report** that can be shared and monitored over time.

## Who it is for

* **Crypto funds** — assess exposure across a portfolio of wallets and rank what to act on first.
* **Protocol treasuries** — understand concentration, dormancy, and migration-readiness for treasury-controlled wallets.
* **Custodians & wallet providers** — evaluate exposure across many customer wallets and plan migration programs.
* **Auditors & security researchers** — a structured, source-cited exposure assessment with confidence levels and caveats.
* **Early-stage investors & design partners** — a clear artifact for understanding wallet risk posture.

## Primary workflow

WalletWall follows one loop everywhere — **scan → assess → recommend → report → monitor**:

1. **Scan** — search or select a wallet address or ENS name.
2. **Assess** — see its exposure across quantum, concentration, dormancy, and behavior.
3. **Recommend** — get a normalized risk tier and a migration-readiness path.
4. **Report** — generate a shareable Wallet Risk Report.
5. **Monitor** — track the wallet's tier and exposure over time.

The same loop, seen as a user's journey across the product — entirely read-only, with no wallet connection at any step:

```mermaid theme={null}
journey
    title A safe path through WalletWall (read-only, no wallet connection)
    section Discover
      Search a wallet, token, or holder list: 5: You
      Browse holders and whale activity: 4: You
    section Assess
      Review exposure and its risk tier: 4: You
      Check evidence quality and confidence: 5: You
    section Research
      Read the migration-readiness path: 4: You
      Explore the testnet vault rehearsal: 3: You
    section Next step, outside WalletWall
      Plan any migration with your own tools: 5: You
```

*WalletWall guides the analysis; it never executes a migration, moves funds, or signs on your behalf. The final step happens in your own wallet and tools.*

## Core modules

<CardGroup cols={2}>
  <Card title="Quantum Intelligence" icon="atom" href="/features/quantum-intelligence">
    The cross-cutting scoring framework: signature/public-key exposure, value at risk, dormancy, and migration readiness. Powers the Quantum Exposure Score and the Quantum Exposure Clock.
  </Card>

  <Card title="Migration Readiness" icon="route" href="/concepts/migration-readiness">
    Turns exposure into a recommended path. Normalizes every wallet into a shared tier — Monitor, Review, Migrate, or Vault Candidate — with an explicit next action. Vault candidates route to the Stablecoin Vault readiness journey.
  </Card>

  <Card title="Whale Watcher" icon="eye" href="/features/whale-watcher">
    The primary wallet intelligence workspace. Activity heatmap, behavioral signals, narratives, holdings, and protocol affinity for a single wallet.
  </Card>

  <Card title="Holder Wall" icon="chart-tree-map" href="/features/holder-wall">
    Zoomable ownership map of top token holders, concentration, rank deltas, and a per-wallet drawer with the Quantum Exposure Card.
  </Card>

  <Card title="Stable Seer" icon="scale-balanced" href="/features/stable-seer">
    Stablecoin and DEX-pair intelligence — peg deviation, liquidity depth, and concentration context that informs stablecoin exposure.
  </Card>

  <Card title="Wallet Risk Reports" icon="file-shield" href="/concepts/scoring-methodology">
    A shareable report that packages exposure, concentration, dormancy, and a migration-readiness recommendation into one artifact for funds, treasuries, and pilots.
  </Card>
</CardGroup>

<Note>
  WalletWall also includes **Coinstellation**, a wallet-relationship graph built from public transaction history. It provides relationship context that feeds the assessment but is not itself a scoring module.
</Note>

## Ecosystem overview

WalletWall is one platform made of several purpose-built surfaces that share a common read-only data and evidence layer underneath.

```mermaid theme={null}
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#B84923', 'primaryTextColor': '#FFF7E8', 'primaryBorderColor': '#6B2412', 'lineColor': '#8A5A1F', 'background': '#FAFAF0', 'mainBkg': '#B84923', 'textColor': '#2B2118'}}}%%
mindmap
  root((WalletWall))
    Wallet Intelligence
      Holder Wall
      Whale Watcher
      Coinstellation
      Stable Seer
    Quantum Intelligence
      Quantum Exposure Score
      Migration Readiness
    Stablecoin Vault
      Vault Simulator (Sepolia)
    Evidence Layer
      Wallet Evidence Model
      Readiness Packet
    Data Sources
      Etherscan
      Alchemy
      DeFiLlama
      CoinGecko
      Dune (scheduled/cached)
```

*Every surface reads from the same read-only data sources and the same evidence layer. No surface takes custody of funds, requests a wallet signature, or executes a transaction.*

## Current status & prototype boundaries

WalletWall is an actively developed platform. Its analytical modules (Holder Wall, Whale Watcher, Stable Seer, Quantum Intelligence) run on live public data and scheduled Dune queries. Some capabilities are explicitly early-stage:

* **The Stablecoin Vault is the flagship vault readiness journey** at `vault.walletwall.org` / `/stablecoin-vault`. It is a testnet research prototype — not production custody, not audited, and must not be used for real funds. The Vault Simulator (`/vault`) is the Sepolia testnet rehearsal detail, surfaced only from the Testnet Rehearsal readiness outcome.
* **Quantum exposure is forward-looking.** A high Quantum Exposure Score does **not** mean a wallet is currently vulnerable to any existing technology. It is a heuristic for long-term migration planning.
* **Scores carry confidence and caveats.** When source data is missing or stale, WalletWall lowers confidence or returns "Unknown" rather than inventing precision.
* **Every product surface states its boundary in the UI.** A persistent scrolling disclaimer rail (`ProductBoundaryTicker`) runs across Holder Wall, Stable Seer, Coinstellation, Whale Watcher, Watchlist, and Quantum surfaces with conservative per-surface copy (read-only, no custody, estimates labelled as estimates). On mobile it renders as a compact second rail line rather than being hidden.

## What WalletWall is not

* **Not asset protection.** WalletWall is risk intelligence and prioritization. It does not move, lock, insure, or protect funds.
* **Not custody, and it does not sign.** No wallet connection, no private keys, no signing.
* **Not a Q-Day prediction.** It measures wallet-specific exposure, not the timing of any future quantum capability.
* **Not a verdict that a wallet is "hacked," "unsafe," or "quantum-vulnerable."**
* **Not investment advice.**

## Next steps

<CardGroup cols={2}>
  <Card title="Scoring Methodology" href="/concepts/scoring-methodology">
    How exposure is computed, the inputs and outputs, and what the shared risk tiers mean.
  </Card>

  <Card title="Quantum Exposure Clock" href="/concepts/quantum-exposure-clock">
    Why quantum exposure is wallet-specific, and how WalletWall turns it into readiness.
  </Card>

  <Card title="Migration Readiness" href="/concepts/migration-readiness">
    The Monitor / Review / Migrate / Vault Candidate tiers and what each suggests.
  </Card>

  <Card title="Quantum Intelligence" href="/features/quantum-intelligence">
    The full scoring model and Dune feeds behind the assessment.
  </Card>

  <Card title="Public and private repositories" href="/concepts/public-and-private">
    What WalletWall makes public, what stays private, and why the two are separate from production readiness.
  </Card>
</CardGroup>