Skip to content

Conversation

JohnnyWyles
Copy link
Collaborator

What is the purpose of the change

Add Supply Endpoints to the mint module to make querying Osmosis supply metrics onchain easier.

/burned_supply - a named way to query the uosmo in the null address
/total_supply - minted uosmo, minus burned supply. This will overwrite until the Superfluid Offsets are removed as it uses minted uosmo, not the offset supply.
/restricted_supply - uosmo in addresses owned by known entities (Developer Vesting, Developer Vested, Community Pool, Restricted Addresses are any addresses in restricted_addresses which may be foundation or investor addresses.
/circulating_supply - minted uosmo minus burned supply, minus restricted supply. This is equivalent to the public float and is the current methodology used by Coingecko and CMC for circulating supply.

Modify the /inflation endpoint to be based on emissions into the new /circulating_supply instead of the uosmo with offsets minus burn. This still contains dev vesting unlocks despite them not adding to the tracked circulating supply as it tracks unlocks rather than increase in circulating supply.

Testing

I have tested most outputs on Edgenet, except for initializing restricted supply through an upgrade and verifying the address balances for those.

Documentation and Release Note

  • Does this pull request introduce a new feature or user-facing behavior changes?
  • Changelog entry added to Unreleased section of CHANGELOG.md?

Where is the change documented?

  • Specification (x/{module}/README.md)
  • Osmosis documentation site
  • Code comments?
  • N/A

@github-actions github-actions bot added C:CLI C:x/mint C:app-wiring Changes to the app folder C:simulator Edits simulator or simulations labels Oct 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

C:app-wiring Changes to the app folder C:CLI C:simulator Edits simulator or simulations C:x/mint

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant