​

Coinstellation

Coinstellation is a supporting signal surface that adds wallet relationship and movement context to vault-readiness decisions. It renders the on-chain connections of an Ethereum wallet as an interactive node-edge visualization — counterparties, clusters, and transaction paths — built from read-only transaction history sourced from Etherscan, Alchemy, and The Graph. It explains the relationship context behind a readiness recommendation; it does not infer identity, intent, or ownership.

​

Homepage Path Finder preview

The homepage includes a looping Coinstellation Path Finder preview (CoinstellationTracePath). It shows a compact animated path through the Coinstellation journey and links users into the full Coinstellation route. The Path Finder is a visual navigation preview. It is not a live graph query and does not replace the wallet graph returned by GET /api/wallet. The full Coinstellation graph still loads only after a wallet address or ENS name is submitted, then renders source-backed nodes, edges, sampling metadata, and data quality indicators.

​

Galaxy graph

The graph renders wallet addresses, tokens, DeFi protocols, NFTs, and counterparties as nodes connected by weighted edges. It is displayed in a 2D/3D interactive canvas using Three.js. Nodes are laid out to emphasize relationship clusters: wallets with high transaction volume to the same protocol or counterparty appear closer together.

​

Entry points

Coinstellation can be reached from:

• A direct wallet address or ENS name entered in the search bar
• Clicking a tile in Holder Wall
• Selecting a wallet from the Whale Watcher workspace

​

Node types

​

Edge relationships

Edges represent transaction relationships derived from loaded Ethereum wallet activity:

• Wallet-to-token: the wallet holds or traded this token
• Token-to-protocol: the token flows through this protocol
• Token-to-counterparty: the token was sent to or received from this counterparty

Edge weight (weightUSD) is the USD-like value of cumulative transactions between the two nodes. txCount records the number of interactions.

​

Click-to-explore

Clicking any node opens the NodeDetailPanel. Clicking an edge highlights the transaction path between the two connected nodes. Double-clicking a counterparty node or wallet node initiates a graph expansion, loading that node’s own transaction graph and appending its relationships to the current view.

​

Interaction flow

Coinstellation is reached from a direct search, a Holder Wall tile, or the Whale Watcher workspace. Clicking a node opens its detail panel, clicking an edge highlights the transaction path, and double-clicking a counterparty or wallet node expands the graph.

​

NodeDetailPanel tabs

The NodeDetailPanel has three tabs:

​

Observability badge

An observability badge in the graph header shows the data source and provider for the current wallet: The tooltip shows provider, partial flag, freshness, and response duration.

​

Data sources

Coinstellation is powered by the GET /api/wallet endpoint. Provider selection is automatic: The mock provider never calls external APIs. It produces deterministic graph data seeded from the wallet address using ethers.id.

​

Transaction sampling

The API loads up to a configured sample limit of normal transactions per wallet. The transactionSample field in the response reports: When isSampled is true, the graph may be incomplete. A data-quality strip at the bottom of the screen notes partial data without alarming copy.

​

Whale Watcher context

From any wallet node in Coinstellation, the Whale Watcher workspace can be opened for that wallet. This transitions from graph exploration to the full intelligence workspace.

​

Label sanitization

Node labels are sanitized via sanitizeLabel before display. Phishing symbols and spam content are redacted. Raw counterparty labels from providers are never shown unmodified.

​

Related surfaces