Skip to content

feat: The Fossil Record — Attestation Archaeology Visualizer (#2311) #1821

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Scottcjn merged 1 commit into from
Mar 25, 2026
Merged

feat: The Fossil Record — Attestation Archaeology Visualizer (#2311) #1821

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions web/fossils/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# The Fossil Record — Attestation Archaeology Visualizer

**Bounty #2311 · 75 RTC**

Interactive D3.js visualization of RustChain attestation history, rendered as geological strata.

## Features

- **Stacked Area Chart** — architecture layers ordered by age (68K deepest, x86 on top)
- **Streamgraph Mode** — centered flow view for temporal dynamics
- **Normalized Mode** — percentage-based to see market share shifts
- **Interactive Tooltips** — hover any layer for miner count, epoch, RTC earned, share %
- **Architecture Color Coding** — 11 families from amber (68K) to pale grey (x86)
- **Epoch Settlement Markers** — vertical dashed lines every 25 epochs
- **First Appearance Markers** — shows when each architecture joined the network
- **Responsive** — works on desktop and mobile
- **No Backend Required** — static HTML + D3.js, deployable at `rustchain.org/fossils`

## Architecture Color Map

| Architecture | Color | Depth |
|---|---|---|
| 68K | Dark Amber | Deepest |
| G3 | Warm Gold | |
| G4 (PowerPC) | Copper | |
| G5 (PowerPC) | Bronze | |
| SPARC | Crimson | |
| MIPS | Jade | |
| POWER8 | Deep Blue | |
| ARM | Saddle Brown | |
| Apple Silicon | Silver | |
| Modern x86 | Pale Grey | |
| Virtual Machine | Dark Grey | Surface |

## Deployment

Copy `index.html` to `rustchain.org/fossils/`:

```bash
cp web/fossils/index.html /var/www/rustchain/fossils/index.html
```

No build step, no dependencies beyond D3.js (loaded from CDN).

## Production Integration

The demo uses generated data. To connect to live RustChain data:

1. Replace `generateData()` with a fetch to the attestation API
2. API endpoint: `GET /api/attestations/history?group_by=arch&bucket=epoch`
3. Expected format: `[{epoch, 68k, g4, g5, sparc, mips, power8, arm, apple_silicon, x86, vm, totalRTC}]`

## Tech Stack

- D3.js v7 (CDN)
- Vanilla JS, no framework
- CSS custom properties for theming
- Vintage terminal aesthetic matching rustchain.org
Loading