Merge pull request #294 from input-output-hk/erikd/release-5.0.0

Release 5.0.0

Author: erikd

cardano-db-sync-extended/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Revision history for cardano-db-sync-extended
 
-## 5.0.0 (unreleased)
+## 5.0.0
 
 * Note that this release requires the database to be dropped and recreated.
 * Correct uniqueness constraint on PoolOwner (#251).

cardano-db-sync/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Revision history for cardano-db-sync node
 
-## 5.0.0 (unreleased)
+## 5.0.0
 
 * Note that this release requires the database to be dropped and recreated.
 * Correct uniqueness constraint on PoolOwner (#251).

cardano-db/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Revision history for cardano-db
 
-## 5.0.0 (unreleased)
+## 5.0.0
 
 * Note that this release requires the database to be dropped and recreated.
 * Correct uniqueness constraint on PoolOwner (#251).

cardano-db/src/Cardano/Db/Query.hs

@@ -405,7 +405,9 @@ querySlotUtcTime slotNo = do
             pure (blk ^. BlockTime)
     pure $ maybe (Left $ DbLookupSlotNo slotNo) (Right . unValue) (listToMaybe le)
 
--- | Get the current total supply of Lovelace.
+-- | Get the current total supply of Lovelace. This only returns the on-chain supply which
+-- does not include staking rewards that have not yet been withdrawn. Before wihdrawal
+-- rewards are part of the ledger state and hence not on chain.
 queryTotalSupply :: MonadIO m => ReaderT SqlBackend m Ada
 queryTotalSupply = do
     res <- select . from $ \ txOut -> do

doc/interesting-queries.md

@@ -21,13 +21,14 @@ cexplorer=# select * from meta ;
 
 ```
 
-### Current total supply of Ada (`queryTotalSupply`)
+### Current total on-chain supply of Ada (`queryTotalSupply`)
 
 Note: 1 ADA == 1,000,000 Lovelace
 
-This just queries the UTxO set for unspent transaction outputs.
+This just queries the UTxO set for unspent transaction outputs. It does not include staking rewards
+that have have not yet been withdrawn. Before being withdrawn rewards exist in ledger state and not
+on-chain.
 
-Currently (as of 2020/04/10) this should be the initial genesis supply minus transaction fees so far.
 ```
 cexplorer=# select sum (value) / 1000000 as current_supply from tx_out as tx_outer where
               not exists