Developer onboarding
Common research workflows
from sample artifacts to analysis
One concrete path from sample artifacts to useful analysis. Use this page together with the sample pack and schema reference to get to a first useful notebook quickly.
Workflow 1 — regime-conditioned panel
Load Meta for all chains, extract status.label, confidence.confidence_score, and top drivers, and build a chain-state panel.
import json, pathlib
from pprint import pprint
base = pathlib.Path("sample-pack")
rows = []
for rel in [
"ethereum/2026-03-31/meta.json",
"arbitrum/2026-03-25/meta.json",
"ethereum/2025-04-21/meta.json",
]:
row = json.loads((base / rel).read_text())
rows.append({
"chain": row["chain"],
"date": row["date"],
"label": row["status"]["label"],
"confidence": row["confidence"]["confidence_score"],
"top_driver": row["regime"]["drivers"][0]["metric"] if row["regime"].get("drivers") else None,
})
pprint(rows)Workflow 2 — verify a determinism hash
Use the example on Verification & Evidence Pack to prove that the named regime payload is internally consistent.
Workflow 3 — parse confidence-aware state changes
Treat UNKNOWN/DEGRADED as a first-class state, not as a missing row, and keep freshness and confidence separate from label interpretation.
