viewer: make addresses, tables and charts usable for analysis

[smypmsa]

Found building a dashboard over a real dataset full of wallets, token contracts and transaction hashes. Each item below is something a project could not fix from its own SQL or YAML.

Viewer

• Hex values can be copied whole. Every hex cell has a copy button; columns.<name>.full: true on a panel shows the value unshortened. Before, the full value lived only in a title tooltip and selecting the cell copied the shortened text.

• Explorer links. New optional chain_sources[].explorer_url. Address, transaction and block cells link to <url>/address/…, /tx/…, /block/…. Addresses are detected from their values, tx_hash and block_number by name; a 32-byte value is never guessed to be a transaction, since it may be any bytes32 id. kind overrides either way.

• Column labels and descriptions. columns.<name>.label, .description, .kind per panel. A header with a description is underlined and explains itself on hover. Amount columns explain their decimals, which replaces the unexplained blue dot after their headers.

• Analysis affordances. Each panel links to its SQL in the source bundle (source/queries/*.sql, already shipped, never linked). Tables and charts download their rows as CSV with exact values under the query's column names. Tables over ten rows get a filter.

• Bar labels. With up to 30 bars every bar is labelled, tilted when crowded; hideOverlap used to drop every other one, leaving bars nobody could identify. Past 30 the axis is a scale (a bar per day) and labels thin out as before.

• KPI height. A KPI beside a table or chart keeps its own height instead of stretching to its row-mate's with the number pinned to the bottom of an empty card. Two KPIs side by side still level.

• Link guards. The viewer builds explorer links only from an http(s) base and renders a SQL link only for a path inside the release's source/ directory, whatever the dashboard JSON says; validation already holds explorer_url to http(s), but a release's JSON can be edited after the build. docs/security.md describes what the viewer turns into links.

explorer_url and the SQL paths are written into dashboards/<id>.json, not release.json, so they count toward the content digest. Releases built before this render as they did, without the new links.

CLI

• Missing snapshot. In an ingest project, a dataset whose snapshot apply does not write (a lookup table a script fills in afterwards) passed validation and then failed the build with internal: ENOENT: … stat …. It is now a validation error naming the dataset, its path and a suggested_next.
• Stray key in schema errors. must NOT have additional properties now ends with the key, e.g. : "by size". An unquoted comma in a flow-mapping title splits it into a second key, and the message used to give no hint of it.

Testing

• pnpm test: 369 passed; the 3 live tests (S3, mainnet e2e) skipped.
• Viewer helpers (column kind detection, explorer hrefs, header help, filter, CSV, KPI row pairing) have unit tests; the build test checks the SQL path and explorer_url in the dashboard doc; validate tests cover the new schema fields and the stray-key message.
• Rendered transfer-traffic and protocol-flows by forking their published releases and building with this branch, and usdc-supply from its published results with this branch's viewer; compared each against the live page. The 358-bar daily chart in usdc-supply thins its labels as before.
• A Robinhood Chain project with explorer_url: https://robinhoodchain.blockscout.com rendered every address, transaction and block cell as a working Blockscout link.

Not in this PR: indexing account code or token metadata as datasets. A project that needs them still fills a lookup table from a script.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 578c4df9-ba6d-4964-8808-e1ecd67884af

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}