Coinstellation

Coinstellation is a read-only wallet and entity relationship graph. Click any node to inspect its type, demo address, and connections to other entities — wallets, tokens, DeFi protocols, NFT collections, and counterparties — all from a single interactive SVG surface. Nodes can also carry an anomaly ring, a separate indicator (not a node type) flagging a pattern noted in this demo's fixture data.

This is a public-safe conceptual demonstration built by the WalletWall org to show how Coinstellation's wallet-relationship graph reads, using static fixtures rather than WalletWall's live provider pipeline. It is not the complete production application — see docs/PUBLIC_SAFE_SCOPE.md for exactly what is and isn't in scope here. Nothing here is custody, execution, or investment advice, and conceptual demo output should not be read as equivalent to production analysis.

Coinstellation is part of the WalletWall analytics suite.

No wallet connection required. Coinstellation 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.

Node Types

Type	Meaning
wallet	The Ethereum address being explored (the anchor node)
token	An ERC-20 token contract
defi	A DeFi protocol contract
nft	An NFT contract
counterparty	Another address that transacted with the wallet but isn't otherwise classified

anomaly is not a node type — it's a ring drawn on top of any node above to flag a pattern noted in this demo's fixture data. Node categories are descriptive labels only; they do not establish ownership, identity, or institutional affiliation, and a flagged node is not an accusation of wrongdoing. See docs/DATA_FIXTURES.md for the full fixture schema.

Tech Stack

• React 19 + Vite 8
• SVG-based node/edge graph (no external graph library)
• 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

Coinstellation ships with synthetic demo data in src/data/coinstellation.fixture.json. To wire your own read-only graph 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 graph provider, 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. Demo addresses are clearly labeled and do not represent real entities.