Skip to content

web(dashboard): relabel /local_stats DOA meter honestly (stale-shares != lost work) - #713

Merged
frstrtr merged 1 commit into
masterfrom
dash/local-stats-doa-relabel
Jul 16, 2026
Merged

web(dashboard): relabel /local_stats DOA meter honestly (stale-shares != lost work)#713
frstrtr merged 1 commit into
masterfrom
dash/local-stats-doa-relabel

Conversation

@frstrtr

@frstrtr frstrtr commented Jul 15, 2026

Copy link
Copy Markdown
Owner

What

Relabels the DOA/stale surface on the embedded dashboard so it stops reading as "~100% lost work" when the node is healthy.

The c2pool Hash Rate card labeled global_stats.pool_stale_prop as "DOA+Orphan". That value is the sharechain stale-share rate (orphan + dead shares, share-count based). At low share-difficulty it is dominated by benign orphan churn — observed 0.959 on contabo LTC prod while the true dead_hashrate was 0 and rewarded hashrate was 100% of actual. Operators read "DOA+Orphan: 95.9%" as catastrophic dead-on-arrival loss. It is not.

Change (label/tooltip only — no computation change)

  • pool_stale: "DOA+Orphan""Stale shares", tooltip clarifies it is share-count based, expected-high at low vardiff, and does not reduce miner reward.
  • local_doa (already hashrate-based dead_hashrate/hashrate = true lost work): tooltip makes provenance explicit so it reads as the authoritative unrewarded-work signal.
  • efficiency (share-count): tooltip clarifies orphan churn lowers share-efficiency without cutting PPLNS payout.

Why this is the right layer

The underlying "sharechain dead-share count conflated with DOA" is the #467-class semantics issue, but at the m_sharechain_stats_fn source (consensus/sharechain owned). This PR is the web-layer honest relabel — reversible static drop-in served from --dashboard-dir, no rebuild, no binary cutover required. Charter #1: a dashboard must never lie about prod health.

The c2pool Hash Rate card labeled pool_stale_prop as "DOA+Orphan". At low
share-difficulty that value is dominated by benign sharechain orphan churn
(observed 0.959 on contabo LTC prod while true dead_hashrate = 0, reward = 100%),
so operators misread it as ~100% lost work (DOA).

Relabel it "Stale shares" and add truthful tooltips: the pool stale-share rate
is share-count-based and does not reduce miner reward; the true lost-work signal
is the hashrate-based local DOA meter (dead_hashrate/hashrate). Also clarify that
share Efficiency is share-count based and orphan churn lowers it without cutting
PPLNS payout. Label/tooltip only -- no computation change. Static drop-in
(--dashboard-dir), reversible.

Charter #1: a dashboard must never lie about prod health.
@frstrtr
frstrtr force-pushed the dash/local-stats-doa-relabel branch from 7719b1b to db5e43e Compare July 15, 2026 21:04
@frstrtr
frstrtr merged commit e3a0483 into master Jul 16, 2026
27 checks passed
@frstrtr
frstrtr deleted the dash/local-stats-doa-relabel branch July 16, 2026 02:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant