> ## 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.

# Introduction

> 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 that prepares exposed wallets for safer vault migration before funds move.

# 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 — across long-horizon quantum/signature exposure, stablecoin and asset concentration, dormancy, and whale behavior.

**Vault readiness is the center of gravity.** That assessment becomes a prioritized migration-readiness path — Monitor, Prepare, Testnet Rehearsal, or Not Enough Data — that prepares exposed wallets for safer vault migration before funds move. The Stablecoin Vault is the flagship destination the intelligence feeds.

The product follows one workflow everywhere: **scan → assess → recommend → report → monitor.**

The app does not ask users to connect a wallet, sign transactions, or provide private keys. All data is sourced from public on-chain providers and scheduled analytics queries. WalletWall is read-only intelligence and vault-readiness prioritization — not asset protection or custody.

<Note>
  New here? Start with [What is WalletWall?](/concepts/what-is-walletwall) for the product overview, audiences, and the core workflow. WalletWall is operated as a hosted application; self-hosting is not currently supported.
</Note>

## Product pillars

Each pillar owns a distinct analytical surface and data boundary. They are designed so that holder analytics, wallet graphing, stablecoin intelligence, behavioral intelligence, cryptographic exposure analysis, and vault readiness remain separate and non-conflated.

<CardGroup cols={2}>
  <Card title="Stablecoin Vault" icon="vault" href="/features/vault">
    Flagship vault-readiness and migration journey. The destination the intelligence layer feeds — a read-only vault-readiness assessment at vault.walletwall.org, supported by separate readiness signals (PQ Evidence, Testnet Rehearsal, Proof Artifact Status, ZK/SP1 disclosure). The Vault Simulator (/vault) is the Sepolia testnet rehearsal detail.
  </Card>

  <Card title="Stable Seer" icon="scale-balanced" href="/features/stable-seer">
    Stablecoin intelligence at stable.walletwall.org. Peg deviation detection, liquidity depth, holder/flow analysis, sparklines, risk console summary, and pool map. Feeds Stablecoin Vault readiness.
  </Card>

  <Card title="Holder Wall" icon="chart-tree-map" href="/features/holder-wall">
    Zoomable treemap of top token holders. Shows ownership concentration, rank deltas, leaderboard, and per-wallet drawer with Quantum Exposure Card. Routes valid EVM wallets to Stablecoin Vault readiness.
  </Card>

  <Card title="Quantum Intelligence" icon="shield-halved" href="/features/quantum-intelligence">
    Cross-cutting cryptographic risk context. Signature exposure score, vault readiness, dormancy signals, and migration readiness. Routes vault candidates to Stablecoin Vault.
  </Card>

  <Card title="Whale Watcher" icon="eye" href="/features/whale-watcher">
    Full wallet intelligence workspace. 12-week activity heatmap, adversarial signals, narrative engine, holdings strip, and protocol affinity bar.
  </Card>

  <Card title="Coinstellation" icon="diagram-project" href="/features/coinstellation">
    Constellation graph of wallet relationships. Nodes and edges built from Etherscan, Alchemy, and The Graph transaction history.
  </Card>
</CardGroup>

## Tech stack

* **Frontend**: React 18, Vite, Three.js, Recharts
* **API**: Node/Vercel serverless handlers in `api/`
* **On-chain data**: Etherscan, Alchemy, CoinGecko, The Graph, Dune Analytics
* **AI narratives**: OpenRouter, OpenAI, or Anthropic (optional; first available provider wins)
* **Caching**: Upstash Redis REST (optional; in-memory fallback when not configured)

## Data posture

All wallet data is read-only public Ethereum data. No private keys, seed phrases, or wallet signatures are used anywhere in the stack.

Dune Analytics data is scheduled and cached — it is never live streaming. The UI labels all Dune-sourced data as `Scheduled/Cached` via a data-source badge and a data-quality strip.

## Next steps

<CardGroup cols={2}>
  <Card title="Architecture flows" href="/architecture/flows">
    Product boundary maps and API security posture diagrams.
  </Card>

  <Card title="Dune queries" href="/development/dune-queries">
    Scheduled query contracts, staleness thresholds, and data guardrails.
  </Card>

  <Card title="Public and private repositories" href="/concepts/public-and-private">
    Which WalletWall artifacts are open, what stays private, and why WalletWall is not fully open source.
  </Card>
</CardGroup>