Skip to content

Repository files navigation

Stable Seer

Stable Seer is a read-only stablecoin peg monitor. Enter a search query to filter stablecoins by symbol, name, or issuer. Click any coin to see peg price, deviation, total liquidity, pool breakdown, and chain coverage — all from a single focused surface.

Stable Seer is part of the WalletWall organization's public research and demonstration surface — a conceptual, read-only preview of the peg-monitoring surface in the WalletWall analytics suite, not the complete production application. It runs on static fixture data as documented below; production behavior is not represented here unless explicitly documented.

No wallet connection required. Stable Seer never asks for private keys, seed phrases, or transaction signatures. All data is read-only from static fixture data unless wired by the user to their own read-only source.

Disclaimers

  • Demo data only. All values are synthetic fixture data by default.
  • No wallet connection. This surface never connects to a wallet provider.
  • No custody. No funds are held, managed, or accessed.
  • No signing. No transaction construction or signing of any kind.
  • No transactions. No on-chain write operations.
  • No paid Dune execution. No live Dune query paths or paid analytics execution.
  • Not financial advice. Nothing in this surface constitutes financial advice.
  • Not production quantum protection. No quantum-resistant vault claims.

Tech Stack

  • React 18 + Vite 6
  • Static fixture data (no live API dependencies)
  • Vitest + Testing Library for tests

Local Development

npm install
npm run dev

This starts the Vite dev server at http://localhost:5173. The app runs entirely on static fixture data — no API keys or environment variables required.

Commands

npm run dev             # Vite dev server
npm run build           # Production build
npm run test            # Run test suite
npm run security:audit  # npm audit at moderate severity
npm run check           # test + build + audit

Replacing Fixture Data

Stable Seer ships with synthetic demo data in src/data/stable-seer.fixture.json. To wire your own read-only data:

  1. Replace the fixture file contents with your data, matching the schema in docs/DATA_FIXTURES.md.
  2. Ensure your data source is read-only — no write access, no private keys.
  3. If connecting to a live API, build a server-side proxy that holds credentials outside this repository.

See docs/DATA_FIXTURES.md for the full fixture schema.

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md. To report a vulnerability, open a GitHub Security Advisory or email security@walletwall.org.

Data Attribution

All fixture data is synthetic and for demonstration purposes only.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages