Time-based Total Supply summary endpoint for Scan API

[waynecollier-da]

Create a Total Coin Supply endpoint in Scan API.

As an instance of the Amulet incentive app, Canton Coin defines a minting curve in which a new set of Canton Coin can be earned and minted every ten minutes by Super Validators, Validators and application providers.

The total supply at any time depends on how many of the allowed Canton Coin have actually been minted by these three sets of network participants. In early stages of MainNet, various caps limit the total Canton Coin actually minted, until a large enough number of Validators and applications join the network (Super Validator minting is not capped, but is limited to a portion of the total available mint).

Entities that hold Canton Coin find it valuable to understand how their holdings compare with the total available supply. They also find it valuable to know the total allowed amount of Canton Coin that was allowed by the minting curve but was not minted due to the caps. This allowed but unminted Canton Coin represents Canton Coin that could be minted in future rounds in the network, above the scheduled amount in a given round. Super Validators may vote at any time to allow network parties to mint this Coin in return for work or other value added to the Global Synchronizer.

Specifically:

For a given input date-time, report for Canton Coin:

Total allowed mint to date
Total minted to date
Total allowed to date but not minted
Total burned to date
Total current supply
Total locked and unlocked
Total unlocked
Total locked