Educational explainer: the ehash epoch lifecycle (learnmeabitcoin style)

vnprc-agent commented

2026-08-12 18:07:56 +01:00

Collaborator

Build an educational explainer of the ehash epoch lifecycle in the style of learnmeabitcoin.com: simple diagrams, step-through animations, concepts only — no code, no protocol minutiae. The deliverable lands on the hashpool website; this issue sits on the epoch roadmap because the design doc is its source material.

Primary goals:

One continuous story — a miner submits a share → the share becomes a quote at the mint → quotes mint into the current epoch's ehash → the pool wins a block → the reward lands at the mint's address → the epoch closes and a new one opens, named by that block height.
The two ideas worth animating — the maturity window (why freshly-won ehash waits out D confirmations before it can be swept, and why nothing real is lost while waiting — the coinbase itself is locked for 100 blocks), and the reorg story (the boundary quietly dissolves, quotes slide back into the previous epoch, nobody loses anything, because nothing irreversible happened yet).
learnmeabitcoin discipline — each concept gets a plain sentence, a simple diagram, and an optional animation; jargon introduced only after its plain-words version; a reader with no cashu background should follow the whole page.
Redemption teaser, not coverage — end with "old ehash waits for redemption", pointing forward to the settlement milestone without explaining it.

Current state and specifics

Source material: docs/EPOCH_DESIGN.md (canonical mechanics) and docs/SETTLEMENT_DESIGN.md (the forward pointer). The website repo already carries dev logs and media; this is its first concept-explainer page. Visual vocabulary to establish and reuse: shares as a stream, quotes as rows in the mint's book, epochs as colored spans on a chain timeline, the reward as the event that changes the color.

Witness

A reader test, not a code test: someone unfamiliar with the project reads the page cold and can answer — what is an epoch, why does new ehash wait after a block win, what happens in a reorg. Diagrams render without JavaScript; animations degrade to static steps.

Scope

In: one page (or one page plus a glossary box) in the website repo, diagrams and animations included. Out: low-level protocol documentation, settlement/redemption mechanics, mining-pool background material beyond one linking paragraph.

Part of #13. Gated on the design doc merging (PR #12); parallel to all code issues.

Build an educational explainer of the ehash epoch lifecycle in the style of learnmeabitcoin.com: simple diagrams, step-through animations, concepts only — no code, no protocol minutiae. The deliverable lands on the hashpool website; this issue sits on the epoch roadmap because the design doc is its source material. Primary goals: - **One continuous story** — a miner submits a share → the share becomes a quote at the mint → quotes mint into the current epoch's ehash → the pool wins a block → the reward lands at the mint's address → the epoch closes and a new one opens, named by that block height. - **The two ideas worth animating** — the maturity window (why freshly-won ehash waits out D confirmations before it can be swept, and why nothing real is lost while waiting — the coinbase itself is locked for 100 blocks), and the reorg story (the boundary quietly dissolves, quotes slide back into the previous epoch, nobody loses anything, because nothing irreversible happened yet). - **learnmeabitcoin discipline** — each concept gets a plain sentence, a simple diagram, and an optional animation; jargon introduced only after its plain-words version; a reader with no cashu background should follow the whole page. - **Redemption teaser, not coverage** — end with "old ehash waits for redemption", pointing forward to the settlement milestone without explaining it. ### Current state and specifics Source material: `docs/EPOCH_DESIGN.md` (canonical mechanics) and `docs/SETTLEMENT_DESIGN.md` (the forward pointer). The website repo already carries dev logs and media; this is its first concept-explainer page. Visual vocabulary to establish and reuse: shares as a stream, quotes as rows in the mint's book, epochs as colored spans on a chain timeline, the reward as the event that changes the color. ### Witness A reader test, not a code test: someone unfamiliar with the project reads the page cold and can answer — what is an epoch, why does new ehash wait after a block win, what happens in a reorg. Diagrams render without JavaScript; animations degrade to static steps. ### Scope In: one page (or one page plus a glossary box) in the website repo, diagrams and animations included. Out: low-level protocol documentation, settlement/redemption mechanics, mining-pool background material beyond one linking paragraph. Part of #13. Gated on the design doc merging (PR #12); parallel to all code issues.

vnprc-agent referenced this issue

2026-08-12 18:08:17 +01:00

Mining epochs: per-epoch currency units and reward-triggered rotation (tracking) #13