InactiveIssuance

Storage Plain v101 → v472 · 1 shape change

Total amount of tokens that are inactive (not in circulation).

Explore chain
Queried by: analyticsdevelopers

The Big Picture

Some tokens exist on-chain but are not part of active circulation - burned tokens, permanently locked amounts, etc. InactiveIssuance tracks this, allowing calculation of true circulating supply: TotalIssuance - InactiveIssuance.

Use Cases

  • Calculate active circulating supply
  • Track burned or locked tokens
  • Build tokenomics dashboards

From Chain Metadata

The total units of outstanding deactivated balance in the system.

Purpose & Usage

Purpose

Track tokens that exist but are not actively circulating.

Common Query Patterns

  • Single value query

Migration Notes

v424 v432 Breaking

value type changed from u64 to TaoBalance

Update decoders: SCALE encoding is positional, so any signature change (added, removed, or type-changed fields, or storage shape changes) shifts byte offsets and existing decoders will misparse this item. Re-derive types from the new metadata.

Stored Value

Value in RAO (÷10⁹ for TAO)

Default Value

0 0x0000000000000000

Absent keys read as this value — querying a key that has never been written returns this default, not an error or empty result.

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Query InactiveIssuance storage (no keys - plain value)
const result = await api.query.Balances.InactiveIssuance.getValue();
console.log("InactiveIssuance:", result);

Version History

v101 block 1 Added
v425–v431 · runtime versions skipped on chain (never deployed)
v432 block 8,636,190 Shape changed Current
  • value : u64 → TaoBalance

Runtime Info

Pallet
Balances
Storage Kind
Plain
First Version
v101
Current Version
v472