An overview of the token component of the CityCoins protocol.
CityCoins are fungible tokens on the Stacks blockchain with no ICO, no pre-sale, and no pre-mine.
CityCoins can be sent and received using a STX address, used for payment in smart contracts, and more.
Miners receive coinbase rewards for mining CityCoins outlined in the table on this page per block.
There is a bonus block reward for early miners who participate in the first 10,000 blocks.
After the final halving the total supply is estimated to be 17,500,000,000 CityCoins and will increase indefinitely by an estimated 164,062,500 CityCoins per year.
The values above are denoted in CityCoins, and the values in the contract and APIs the value will represent the reward/supply above multiplied by
1,000,000to account for the 6 decimal places as micro-CityCoins.
CityCoins have 6 decimals, denoted with
Since CityCoins have 6 decimals, there will be places that may show the balance of
CityCoins * 1,000,000. This is not a bug.
What's showing is the "raw" value on-chain, which represents micro-CityCoins. Consider a
50,000 MIAblock reward - claiming from the contract will mint
50,000,000,000 uMIAwhich is then displayed correctly in wallets based on the number of decimals.
You can also see this in V1 to V2 conversion transactions, where for example,
50 MIA (V1)is burned and
50,000,000 uMIA (V2)minted, and both are equivalent in value because V2 MIA has 6 decimal places.