docs: block subsidy clarification and treasury expansion (dashpay#309)

* docs: update block reward to block subsidy where required

Block reward (subsidy + tx fees) was used in some places where block subsidy (just the newly minted Dash) was intended. This resolves those discrepancies

* docs: add info about treasury expansion

* style: fix heading

* docs: clarify additional block subsidy / reward cases

docs/user/governance/index.rst

@@ -23,15 +23,15 @@ and even forks to the Bitcoin blockchain.
 
 The DAO also provides a means for Dash to fund its own development. While other 
 projects have to depend on donations or premined endowments, Dash uses 10% of 
-the block reward to fund its own development. Every time a block is mined, 90% 
-of the reward is split between the miner and a masternode per the distribution 
+the block subsidy to fund its own development. Every time a block is mined, 90% 
+of the subsidy is split between the miner and a masternode per the distribution 
 found :ref:`here <block-reward-reallocation>`, while the remaining 10% is not 
 created until the end of the month. During the month, anybody can make a budget 
 proposal to the network. If that proposal earns the net approval of at least 10% 
 of the masternode network, then at the end of the month the requested amount will 
-be paid out in a "superblock". At that time, the block rewards that were not paid 
+be paid out in a "superblock". At that time, the block subsidies that were not paid 
 out (10% of each block) will be used to fund approved proposals. The network thus 
-funds itself by reserving 10% of the block reward for budget projects.
+funds itself by reserving 10% of the block subsidy for budget projects.
 
 
 .. raw:: html

docs/user/governance/understanding.rst

@@ -40,7 +40,7 @@ mechanism. Masternode operators are not the only ones interested in the
 success of Dash, but they are the most stable ones because, unlike
 miners, they can’t reuse their asset for any other purpose or coin.
 
-In the budget system, a portion of the block reward is held in escrow by
+In the budget system, a portion of the block subsidy is held in escrow by
 the network itself, in the name of the operators, to be executed in the
 development and expansion of the ecosystem according to the vote of the
 masternodes in different budget proposals. These funds are directed to
@@ -107,7 +107,7 @@ Reward schedule
 ===============
 
 To guarantee long term sustainability of the blockchain, the network
-keeps a portion of the block rewards back as new blocks are created,
+keeps a portion of the block subsidy back as new blocks are created,
 with the masternode operators tasked to act as stewards and invest in
 the maintenance and expansion of the network by voting. This results in
 faster development and promotion, creating a virtuous cycle that
@@ -121,7 +121,7 @@ preservation mechanism that is beyond the control of any individual.
 | 10% | Decentralized Governance Budget        |
 +-----+----------------------------------------+
 
-Masternodes and miners split 90% of the mining reward per the distribution
+Masternodes and miners split 90% of the mining subsidy per the distribution
 found :ref:`here <block-reward-reallocation>`, at the time
 it is created. The remaining 10% is disbursed monthly by the masternode
 operators once the results of their votes are tallied, creating the
@@ -142,7 +142,7 @@ introduction of the decentralized governance budget itself was decided
 by a masternode vote, making the first distributed decision the actual
 creation of the system, similar to establishing a constitution.
 
-This approach of distributing the normal block reward in a way that
+This approach of distributing the normal block subsidy in a way that
 considers all critical elements a cryptocurrency needs for its long term
 viability, e.g. mining, full nodes, development and promotion, is
 revolutionary as it is done without changing the emission or creating
@@ -166,11 +166,11 @@ this stage. Several tools exist to allow masternode operators to
 comfortably review and vote on proposals. The net total of yes votes must
 exceed 10% of the total masternode count at the time votes are tallied
 in order to pass. If there are more passing proposals than the available
-block reward can provide for, the proposals with the most yes votes will
+block subsidy can provide for, the proposals with the most yes votes will
 pass first, creating a cut-off point for less popular proposals. The
 same process is then repeated every month, and the total amount of Dash
 available for proposals decreases by approximately 7.14% per year,
-together with the overall block reward.
+together with the overall block subsidy.
 
 The following video by Tao of Satoshi includes advice for proposal
 owners entering proposals during periods of high competition for the
@@ -263,7 +263,7 @@ Budget allocation
 =================
 
 The total budget of the network can be calculated by taking 10% of the
-reward over the period of time between two superblocks, which occur
+block subsidy over the period of time between two superblocks, which occur
 every 16616 blocks or approximately 30.29 days. A voting cutoff occurs
 1662 blocks before the superblock, and the final votes are tallied at
 this point. A proposal must satisfy the condition ``(YES votes - NO

docs/user/introduction/features.rst

@@ -17,7 +17,7 @@ Specifications
 - No premine
 - X11 hashing algorithm, CPU/GPU/ASIC mining available
 - 2.6 minute block time, 2MB blocks, ~56 transactions per second
-- Block reward decreases by 7.14% per year
+- Block subsidy decreases by 7.14% per year
 - Dark Gravity Wave difficulty adjustment algorithm
 - Between 17.74M and 18.92M total coin supply
 - Decentralized second-tier masternode network
@@ -54,7 +54,7 @@ Masternodes enable the following services:
 -  **ChainLocks**, which protects the blockchain against 51% mining 
    attacks by signing blocks as they are mined.
 -  **Governance and Treasury** allows stakeholders in Dash to determine
-   the direction of the project and devotes 10% of the block reward to
+   the direction of the project and devotes 10% of the block subsidy to
    development of the project and ecosystem.
 -  **Dash Evolution** will make using cryptocurrency as easy as using
    PayPal.
@@ -72,7 +72,7 @@ of the block reward as an incentive. Because only one masternode is paid
 in each block, the frequency of the payment can vary, as well as the
 value of the Dash paid out. This `tool <https://stats.masternode.me/>`_
 shows a live calculation of masternode earnings. These rewards decrease
-by 7% each year, together with the block reward. There is also the
+by 7% each year, together with the block subsidy. There is also the
 possibility for masternodes to earn money from fees in the future.
 
 Evolution Masternodes (evonodes)
@@ -380,8 +380,8 @@ repeatedly solving :ref:`hash algorithms <x11-hash-algorithm>` until a
 valid solution for the current :ref:`mining difficulty 
 <dark-gravity-wave>` is discovered. Once discovered, the miner is 
 permitted to create new units of the currency. This is known as the 
-block reward. To ensure that the currency is not subject to endless 
-inflation, the block reward is reduced at regular intervals, as `shown 
+block subsidy. To ensure that the currency is not subject to endless 
+inflation, the block subsidy is reduced at regular intervals, as `shown 
 in this calculation
 <https://docs.google.com/spreadsheets/d/1HqgEkyfZDAA6pIZ3df2PwFE8Z430SVIzQ-mCQ6wGCh4/edit#gid=523620673>`_.
 Graphing this data results in a curve showing total coins in 
@@ -392,7 +392,7 @@ emission rate to offer a smoother reduction in coin emission over time.
 While Bitcoin reduces the coin emission rate by 50% every 4 years, Dash
 reduces the emission by one-fourteenth (approx. 7.14%) every 210240
 blocks (approx. 383.25 days). It can be seen that reducing the block
-reward by a smaller amount each year offers a smoother transition to a
+subsidy by a smaller amount each year offers a smoother transition to a
 fee-based economy than Bitcoin.
 
 
@@ -408,13 +408,13 @@ Total coin emission
 2tR_9WrY0Hj4AQLoJYj9EDBzfA38XIVLQSOOOVePNm0/pubhtml?gid=0&single=true>`_
 can be calculated as the sum of a geometric series, with the total
 emission approaching (but never reaching) 21,000,000 BTC. This will
-continue until 2140, but the mining reward reduces so quickly that 99%
+continue until 2140, but the mining subsidy reduces so quickly that 99%
 of all bitcoin will be in circulation by 2036, and 99.9% by 2048.
 
 `Dash's total coin emission <https://docs.google.com/spreadsheets/d
 /1JUK4Iy8pjTzQ3Fvc-iV15n2qn19fmiJhnKDDSxebbAA/edit#gid=205877544>`_ is
 also the sum of a geometric series, but the ultimate total coin emission
-is uncertain because it cannot be known how much of the 10% block reward
+is uncertain because it cannot be known how much of the 10% block subsidy
 reserved for budget proposals will actually be allocated, since this
 depends on future voting behavior. Dash will continue to emit coins for
 approximately 192 years before a full year of mining creates less than 1
@@ -433,17 +433,17 @@ between:
 Block reward allocation
 -----------------------
 
-Unlike Bitcoin, which allocates 100% of the block reward to miners, Dash
-holds back 10% of the block reward for use in the decentralized
+Unlike Bitcoin, which allocates 100% of the block subsidy to miners, Dash
+holds back part of the block subsidy for use in the decentralized
 :ref:`budget system <decentralized-governance>`. The remainder of the
-block reward, as well as any transaction fees, is split between the
+block subsidy, as well as any transaction fees, is split between the
 :ref:`miner <mining>` and a :ref:`masternode <masternodes>`, which is
 deterministically selected according to the :ref:`payment logic
 <payment-logic>`. Dash features superblocks, which appear every 16616
-blocks (approx. 30.29 days) and can release up to 10% of the cumulative
+blocks (approx. 30.29 days) and can release the cumulative governance
 budget held back over that :ref:`budget cycle period <budget-cycles>` to
 the winning proposals in the budget system. Depending on budget
-utilization, this results in an approximate coin reward allocation over
+utilization, this results in an approximate coin allocation over
 a budget cycle as follows:
 
 +-----+----------------------------------------+
@@ -452,11 +452,24 @@ a budget cycle as follows:
 | 10% | Decentralized Governance Budget        |
 +-----+----------------------------------------+
 
+When Dash Platform is released, the governance budget will grow to 20% per the
+governance proposal approved in September 2023. Additional details can be found
+in the :ref:`Treasury expansion section <block-subsidy-reallocation-treasury-expansion>`.
+
+Miner and masternode reallocation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note::
+
+   This block reward reallocation process was superseded by the :ref:`treasury
+   expansion <block-subsidy-reallocation-treasury-expansion>` approved by the
+   network in 2023.
+
 On 13 August 2020, the Dash network approved a `proposal
 <https://www.dashcentral.org/p/decision-proposal-block-reward-reallocat>`__
 to modify the block reward allocation from 50/50 between miners and
 masternodes to 40/60, respectively. The incremental reallocation adjusts 
-the percentage share every three superblock cycles. 
+the percentage share every three superblock cycles.
 
 .. _block-reward-reallocation:
 
@@ -517,6 +530,25 @@ run your own `emission calculations using this tool
 site <https://stats.masternode.me>`_ for live data on current network
 statistics.
 
+.. _block-subsidy-reallocation-treasury-expansion:
+
+Treasury expansion
+^^^^^^^^^^^^^^^^^^
+
+In September of 2023, the Dash network approved a `proposal
+<https://www.dashcentral.org/p/TREASURY-REALLOCATION-60-20-20>`__ to double the
+governance budget by modifying the block subsidy allocation. The new allocation
+designates 20% for miners, 20% for the governance system budget, and 60% for
+masternodes.
+
++-----+----------------------------------------+
+| 20% | Mining Reward                          |
++-----+----------------------------------------+
+| 20% | Decentralized Governance Budget        |
++-----+----------------------------------------+
+| 60% | Masternode Reward                      |
++-----+----------------------------------------+
+
 .. _decentralized-governance:
 
 Decentralized Governance
@@ -537,17 +569,17 @@ for nearly three years.
 
 DAO also provides a means for Dash to fund its own development. While 
 other projects have to depend on donations or premined endowments, Dash 
-uses 10% of the block reward to fund its own development. Every time a 
-block is mined, 90% of the reward is split between the miner and
+uses 10% of the block subsidy to fund its own development. Every time a 
+block is mined, 90% of the subsidy is split between the miner and
 a masternode per the distribution found :ref:`here <block-reward-reallocation>`,
 while the remaining 10% is not created until the end of the
 month. During the month, anybody can make a budget proposal to the
 network. If that proposal receives net approval of at least 10% of the
-masternode network, then at the end of the month a series of
-"superblocks" will be created. At that time, the block rewards that were
+masternode network, then at the end of the month a
+"superblock" will be created. At that time, the block subsidy that was
 not paid out (10% of each block) will be used to fund approved
 proposals. The network thus funds itself by reserving 10% of the block
-reward for budget projects.
+subsidy for budget projects.
 
 You can read more about Dash governance in the :ref:`governance` section
 of this documentation.

docs/user/introduction/information.rst

@@ -425,14 +425,15 @@ Glossary
     include ATM cards, computer passwords, and electronic commerce.
 
   DAO
-    The development of Dash and the Dash ecosystem is self-funded by the
-    DAO or Decentralized Autonomous Organization. Each time a block is discovered, 
-    90% of the block reward is split between the miner and a masternodes per the 
-    distribution found :ref:`here <block-reward-reallocation>`. 10% is withheld by the
-    network and used to fund projects that are approved by the masternode
-    network. For a fee, anybody can submit a proposal to the network, and will be paid 
-    directly by the blockchain if approved by the masternodes. The Budget System is 
-    sometimes called the Treasury System; the two terms are interchangeable.
+    The development of Dash and the Dash ecosystem is self-funded by the DAO or
+    Decentralized Autonomous Organization. Each time a block is discovered, 90%
+    of the block reward is split between the miner and a masternodes per the
+    distribution found :ref:`here <block-reward-reallocation>`. 10% of the block
+    subsidy is withheld by the network and used to fund projects that are
+    approved by the masternode network. For a fee, anybody can submit a proposal
+    to the network, and will be paid directly by the blockchain if approved by
+    the masternodes. The Budget System is sometimes called the Treasury System;
+    the two terms are interchangeable.
 
   DAP
     Decentralized Application Protocol. This term describes an application

docs/user/masternodes/understanding.rst

@@ -44,7 +44,7 @@ moves or spends those coins, the masternode stops working and payment
 ceases.
 
 Masternodes are paid by the network for the InstantSend, CoinJoin and
-governance services they provide. 10% of the block reward goes to the budget
+governance services they provide. 10% of the block subsidy goes to the budget
 with the remaining 90% split between miners and masternodes per this
 :ref:`block reward reallocation table <block-reward-reallocation>`. 
 Then, every 16,616 blocks (approximately 30.29 days), a
@@ -187,7 +187,7 @@ Nodes), which enable financial privacy (CoinJoin), instant
 transactions (InstantSend), and the decentralized governance and budget
 system. Because this second tier is so important, masternodes are also
 rewarded when miners discover new blocks. The breakdown is as follows:
-90% of the block reward is split between the miner and a masternode
+90% of the block subsidy is split between the miner and a masternode
 per the distribution found :ref:`here <block-reward-reallocation>`, while
 10% is reserved for the budget system (created by superblocks every
 month).

docs/user/mining/index.rst

@@ -59,7 +59,7 @@ two-tier network. The second tier is powered by :ref:`masternodes
 (CoinJoin), instant transactions (InstantSend), and the decentralized
 governance and budget system. Because this second tier is so important,
 masternodes are also rewarded when miners discover new blocks. The
-breakdown is as follows: 90% of the block reward is split between the
+breakdown is as follows: 90% of the block subsidy is split between the
 miner and a masternode per the distribution found :ref:`here <block-reward-reallocation>`,
 while 10% is reserved for the budget system (created by superblocks
 every month).