Data handling, as documented while the surface was liveThe graph is built from live provider reads, briefly cached, over a sample of loaded transactions, so it can be incomplete. Proximity in the graph is not proof of identity, intent, or ownership. See what you can use today for every surface side by side.
What it does
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. It explains the relationship context behind a readiness recommendation; it does not infer identity, intent, or ownership.What you can learn
- Who a wallet interacts with — wallets, tokens, DeFi protocols, NFTs, and other counterparties.
- Where activity clusters — wallets with high transaction volume to the same protocol or counterparty appear closer together.
- How value moved — the cumulative USD-like volume and the number of interactions between any two connected nodes.
- How far a relationship extends — expand a counterparty or wallet to load its own transaction graph into the current view.
How to read it
You can reach Coinstellation 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
The graph
The graph renders wallet addresses, tokens, DeFi protocols, NFTs, and counterparties as nodes connected by weighted edges, in a 2D/3D interactive canvas. Nodes are laid out to emphasize relationship clusters.
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
Exploring
- Click a node to open its detail panel.
- Click an edge to highlight the transaction path between the two connected nodes.
- Double-click a counterparty or wallet node to load that node’s own transaction graph and append its relationships to the current view.
- Open Whale Watcher from any wallet node to move from graph exploration to the full intelligence workspace for that wallet.
- Portfolio
- Volume
- Tx Count
Token balances and estimated USD value held by the selected wallet node. Sourced from CoinGecko price data and on-chain balance calls.
Homepage Path Finder preview
The homepage includes a looping Coinstellation Path Finder preview. It shows a compact animated path through the Coinstellation journey and links users into the full Coinstellation route.Data freshness and provenance
The graph is built from read-only transaction history sourced from Etherscan and Alchemy, read when you submit a wallet and then briefly cached. See Data Serving Architecture for how live provider reads differ from scheduled data. An observability badge in the graph header shows the data source and provider for the current wallet. Its tooltip shows provider, partial flag, freshness, and response duration.
The API loads up to a configured sample limit of normal transactions per wallet. When the response hits that limit, the graph may be incomplete, and a data-quality strip at the bottom of the screen notes partial data without alarming copy.
Important boundaries
- Relationships are not identity. Proximity in the graph is not proof of intent, ownership, or coordination, and the graph does not infer identity. It is context for a readiness review rather than a finding.
- A sampled graph can be incomplete. A missing edge is not evidence that no relationship exists.
- Labels are sanitized. Phishing symbols and spam content are redacted, and raw counterparty labels from providers are never shown unmodified.
- The homepage Path Finder is a visual preview. It is not a live graph query. The full graph loads only after a wallet address or ENS name is submitted, then renders source-backed nodes, edges, sampling metadata, and data quality indicators.
Technical reference
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.API reference
Coinstellation is powered by theGET /api/wallet endpoint. The canvas uses Three.js.
Edge and panel fields
Edge and panel fields
Edge weight (
weightUSD) is the USD-like value of cumulative transactions between the two nodes. txCount records the number of interactions. The NodeDetailPanel’s Volume tab derives from weightUSD on connected edges, and its Tx Count tab from txCount.Observability values
Observability values
Provider selection
Provider selection
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 fields
Transaction sampling fields
The
transactionSample field in the response reports:loadedCount: number of transactions loaded.sampleLimit: configured limit.isSampled: true when the response hit the limit.firstLoadedTxAt/lastLoadedTxAt: ISO timestamps of the loaded window.
Implementation notes
Implementation notes
- Node labels are sanitized via
sanitizeLabelbefore display. - The homepage preview is the
CoinstellationTracePathcomponent. It does not replace the wallet graph returned byGET /api/wallet.
Related pages
Holder Wall
Coinstellation can be opened directly from a Holder Wall tile.
Whale Watcher
Selecting a wallet in the Whale Watcher workspace can open its Coinstellation graph.
Quantum Intelligence
Quantum Intelligence surfaces inside the Coinstellation NodeDetailPanel.

