Zcash Supply: Circulating ZEC and Issuance

Choose the question before choosing a number

A provider-reported supply value describes that provider’s measurement at a height and timestamp. A scheduled subsidy sum describes the amount permitted by a chosen reference algorithm over a specified height range.

Circulating supply additionally requires an explicit definition of excluded funds and supporting evidence. This prototype has no independent node or approved circulating-supply methodology.

A field called supply is therefore displayed with its source, units, method and review state rather than treated as interchangeable with every other total.

The reference rule is versioned

The retrieved mainnet parameters define slow start and the Blossom transition. The reference calculator preserves slow-start integer arithmetic, spacing-ratio height scaling and halving right-shift rounding.

Its output unit is zatoshi, with any ZEC display conversion explicitly separate. The source version matters: draft NU7 changes are not merged into this reference schedule just because a proposal exists.

The halving guide links to the same pinned algorithm and parameter sources.

What the golden comparisons actually establish

A local C++ harness compiles the retrieved GetBlockSubsidy and Halving functions with the relevant reference parameters. Sixteen boundary/range comparisons match the TypeScript calculator.

This is cross-language function parity, not a complete-node compilation, observed block-by-block issuance audit or validation of every future consensus change. Height endpoints, integer rounding and cumulative output are covered; full live Supply Simulator verification remains incomplete.

Hypothetical output is intentionally isolated

A separate scenario accepts user-entered assumptions and labels its result hypothetical. It is not an on-chain rule change, activation prediction, current circulating value or forecast of market price.

The reference and scenario results must stay in different panels and cannot overwrite each other. A reader can inspect exact reference calculations without JavaScript; interactive scenario behavior needs JavaScript and sends no input to a server.

How to compare evidence without mixing dates

Use the network workspace to record one provider observation’s height, as-of, retrieval date, units and source status. Use the reference calculator to choose a height or bounded range and preserve its rule version.

A difference does not automatically identify a reconciliation error: units, cumulative/range meaning, issuance versus circulation and protocol context must first be comparable. Missing observations remain missing and quarantined rows are not used to construct a replacement supply curve.

FAQ