Dashboard: energy & profit calculator — net profit (earnings − power cost), from RigForge's power telemetry

[VijitSingh97]

Goal

Extend the dashboard's earnings calculator (#12, shipped XMR-only; Tari in #117, XvB in #118) with two linked views:

1. Energy — fleet power draw (W), efficiency (H/s per watt), and energy use (kWh / day · month · year), summed across workers.
2. Profit — net profit = gross earnings − energy cost, over the same day / month / year horizons, at a configurable electricity price.

This turns "what does my hashrate earn" into "what does it earn after power — and which rigs actually pay for themselves."

Data source — RigForge's enriched API (use it, don't make the operator guess)

The power numbers come straight from RigForge's sister HTTP API (p2pool-starter-stack/rigforge#99), which already exposes, per worker:

"rigforge": { "power": { "watts": 142.0, "hs_per_watt": 86.9 }, ... }

(sampled via RAPL / TUNE_POWER_CMD, p2pool-starter-stack/rigforge#79). Pithead consumes this feed in #235; this calculator sums watts across workers for total fleet draw and uses hs_per_watt for efficiency.

• Prerequisite: [Feature] Dashboard: consume RigForge's enriched feed (rigforge#99) — update badge + per-worker health / power / tune / firmware #235 (consume RigForge's enriched feed) — the power block must be parsed and surfaced before this can total it.
• Fallback: a worker that doesn't expose power (older RigForge, a non-RigForge rig, or macOS where the probes are Linux-only) falls back to an operator-entered watts estimate, clearly marked "estimated."

Config (config.json)

"dashboard": {
  "energy": {
    "cost_per_kwh": 0.0,   // electricity price; 0/unset ⇒ profit math hidden, energy view still shows draw/efficiency
    "currency": "USD"
  }
}

Default unset → the calculator shows earnings + raw power/efficiency, but hides the profit (cost) math until a price is set. No silent assumption about power price.

What it shows

• Total fleet watts + H/s-per-watt (live), and kWh / day · month · year.
• Energy cost and net profit (gross − cost) per day / month / year, scaling with the same what-if hashrate input the earnings calc already uses.
• Per-worker efficiency, so the operator can spot a rig that's burning more than it earns.

Relationships

• Add XvB and P2Pool calculator #12 (shipped) — XMR earnings calculator this extends.
• Add Tari (merge-mining) earnings to the dashboard calculator #117 / Add XvB tier / raffle calculator to the dashboard #118 — Tari + XvB earnings; profit = (XMR + Tari + XvB earnings) − energy cost, so this rides on top of them.
• [Feature] Dashboard: consume RigForge's enriched feed (rigforge#99) — update badge + per-worker health / power / tune / firmware #235 (v1.5) — consumes RigForge's power block; hard prerequisite for the auto-watts path.
• Sister HTTP API: serve a superset of XMRig's stats, enriched with RigForge-captured data rigforge#99 — the API that exposes power: { watts, hs_per_watt }.
• [Epic] Persist valuable telemetry as time-series — stop discarding block / share-health / disk-growth / XvB / per-worker data #196 — optionally persist a power/efficiency series so net-profit can be charted over time, not just shown as last-value.

Acceptance criteria

• Energy view: fleet watts + H/s-per-watt + kWh/day·month·year, summed from RigForge's power feed ([Feature] Dashboard: consume RigForge's enriched feed (rigforge#99) — update badge + per-worker health / power / tune / firmware #235), with a marked manual-estimate fallback per worker.
• Profit view: net = gross earnings (Add XvB and P2Pool calculator #12 + Add Tari (merge-mining) earnings to the dashboard calculator #117 + Add XvB tier / raffle calculator to the dashboard #118) − energy cost, over day/month/year, at cost_per_kwh.
• Profit math is hidden until cost_per_kwh is set (no assumed price); energy/efficiency still shown.
• Per-worker efficiency surfaced so an unprofitable rig is visible.
• Degrades cleanly when a worker reports no power data.

Milestone

v1.5 — depends on #235 (RigForge power feed). A manual-watts-only MVP could land earlier with the v1.3 calculators (#117/#118) if we want it sooner; the RigForge-driven version belongs with #235.