From b9a405c4a7336b4108e1c3478da072a402fab1fd Mon Sep 17 00:00:00 2001
From: Radha <86818441+DrW3RK@users.noreply.github.com>
Date: Fri, 29 Sep 2023 14:42:09 +0200
Subject: [PATCH] Total, Active and Inactive Issuance (#5192)

* Total, Active and Inactive Issuance

* format the values
---
 docs/learn/learn-DOT.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/learn/learn-DOT.md b/docs/learn/learn-DOT.md
index 05efde3e7344..ef9655a463b5 100644
--- a/docs/learn/learn-DOT.md
+++ b/docs/learn/learn-DOT.md
@@ -7,6 +7,8 @@ keywords: [token, DOT, what are the uses of DOT, KSM, faucet]
 slug: ../learn-DOT
 ---
 
+import RPC from "./../../components/RPC-Connection";
+
 ## What is DOT?
 
 DOT is the native token of the Polkadot network in a similar way that BTC is the native token of
@@ -115,6 +117,45 @@ the future).
    approximately 14’400 blocks per day, and you can see what the latest block is shown on the
    [Explorer](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.polkadot.io#/explorer) page.
 
+### Token Issuance
+
+#### Total Issuance
+
+It is the total number of token units in existence on the network.
+
+:::info On-chain data for reference
+
+The total issuance is
+{{ polkadot: <RPC network="polkadot" path="query.balances.totalIssuance" defaultValue="13557639805348170350" filter= "humanReadable"/>. :polkadot }}
+{{ kusama: <RPC network="kusama" path="query.balances.totalIssuance" defaultValue="14017001595616667835" filter= "humanReadable"/>. :kusama }}
+in the era
+{{ polkadot: <RPC network="polkadot" path="query.staking.currentEra" defaultValue="1200"/>. :polkadot }}
+{{ kusama: <RPC network="polkadot" path="query.staking.currentEra" defaultValue="5649"/>. :kusama }}
+
+:::
+
+#### Inactive Issuance
+
+It is the total units of outstanding deactivated balance on the network that cannot be used for
+participation in governance. This comprises tokens locked away in crowdloans and nomination pools.
+
+:::info On-chain data for reference
+
+The inactive issuance is
+{{ polkadot: <RPC network="polkadot" path="query.balances.inactiveIssuance" defaultValue="1784854324418488473" filter= "humanReadable"/>. :polkadot }}
+{{ kusama: <RPC network="kusama" path="query.balances.inactiveIssuance" defaultValue="320302796457002024" filter= "humanReadable"/>. :kusama }}
+in the era
+{{ polkadot: <RPC network="polkadot" path="query.staking.currentEra" defaultValue="1200"/>. :polkadot }}
+{{ kusama: <RPC network="polkadot" path="query.staking.currentEra" defaultValue="5649"/>. :kusama }}
+
+:::
+
+#### Active Issuance
+
+Active issuance = Total issuance - Inactive issuance
+
+All the tokens under active issuance are can be used to participate in the governance on-chain.
+
 ## Obtaining Testnet Tokens
 
 DOT are required to make transactions on the Polkadot network. Tokens on Polkadot's Testnets like