All field notes

Blockchain · Retrospective

What “circulating supply” means when an exchange asks for it

Three glass jars of beads, the tallest only partly full below a dotted line.
Concept illustration · AI-generated

On 11 May, Bitcoin's block reward fell from 12.5 to 6.25 BTC at its third halving. For a few days everyone could say exactly how Bitcoin's supply would grow and roughly where it would stop. Five days later I updated the Trivechain README with a revised supply table and the list of exchanges where TRVC trades (commit). Its maximum supply line still says "best estimation". That phrase is worth explaining, because it sits underneath the question an exchange asks when it wants a circulating supply figure.

Three numbers that all get called supply

  • Issued supply: every coin created so far, at a given block height.
  • Circulating supply: the part of that which can actually move and trade.
  • Maximum supply: the most that will ever exist.

For Bitcoin, the third follows from the schedule. For Trivechain it does not, and the reason is governance.

Why Trivechain's maximum is an estimate

Since the TRVC 2.0 era began, the block reward has started from 25 TRVC and falls by 25% every 525,600 blocks, which is a year of one-minute blocks. The reward is split three ways: 35% to the miner, 35% to masternodes and 30% to TriveGovernance.

The first two are paid in the block itself. The governance share is not. It is held back and paid out about once a month, in a superblock, and only to proposals that masternode operators have voted through. A budget that no proposal claims is never created at all. Trivechain's eventual supply therefore depends on votes that have not happened yet. The README's table assumes the full governance share is paid out from the third year onwards. If proposals claim less, less TRVC will ever exist, and the eventual total will come in under the estimate.

There is one more small effect. Submitting a governance proposal costs a 50 TRVC fee, paid to an output nobody can spend. Every proposal removes that fee from the supply for good.

What changed in May

The revision moved the estimated maximum from 80,582,104 TRVC to 78,604,474.32101114 TRVC, just under two million lower. Most of the difference comes from the governance share. The earlier table had counted one from block 525,600; the corrected table, which merges the second year into a single row, records none until block 752,255. The arithmetic is in the README, row by row, so anyone can redo it.

I would rather publish an estimate that moves, with its working shown, than a round number that looks final. Anyone who disagrees with an assumption can see exactly which row to argue with.

What I count as circulating

Three cases on Trivechain need a decision rather than a lookup.

  • Masternode collateral. Running a masternode means holding 10,000 TRVC in one output. The protocol does not lock it: the owner can spend it at any time, and the masternode simply stops being paid. I count it as circulating, and I say so.
  • New block rewards. A reward cannot be spent until 100 blocks have passed. At one-minute blocks that is under two hours of issuance, too small to matter, but it is the protocol's own definition of "not yet spendable".
  • The governance budget. It is not sitting in a treasury wallet waiting to be spent. It does not exist until a superblock pays it, so there is nothing to exclude.

The answer I would give an exchange

A supply figure should come with a block height and a method. A full node can total its unspent outputs at a given height, and that total already leaves out burned outputs such as proposal fees. Beside it goes a sentence on what is counted as circulating and why, and the maximum supply, labelled as an estimate with its assumption written next to it.

The README now lists three exchanges: Folgory, BitRabbit and PARS Exchange. Each of them, and each of their users, can read the same table. The number an exchange shows should be one anyone can recompute from the chain, not one they have to take on trust from us.