Tao halving doc

docs/concepts/halving.md

@@ -0,0 +1,27 @@
+# TAO Halving
+
+This page explains the TAO halving mechanism and describes how it affects the creation and distribution of new tokens across the network.
+
+## What is TAO Halving?
+
+**TAO halving** is a scheduled event in the Bittensor network where the block reward is reduced by 50%. This happens automatically at regular intervals based on the amount of TAO in circulation.
+
+:::info
+_Recycling_ of TAO from subnet registration fees can delay halving events. When tokens are recycled, they are returned to the emission pool and removed from circulation. This process continuously extends the time until the next halving threshold is reached.
+:::
+
+## TAO halving Mechanism
+
+Halving occurs when the total TAO issuance reaches predetermined thresholds. Before a halving event, the network emits TAO at its current block reward, with the full amount flowing into subnet pools. Once a halving occurs, the block reward is reduced by 50%, which lowers the daily TAO emission and cuts subnet pool injections in half.
+
+### Effect on Alpha Emissions
+
+Alpha emissions are split into two distinct components that respond differently to the halving. The portion of Alpha tokens that is injected into subnet pools alongside TAO will halve, since it directly tracks TAO emissions at the current price ratio. In contrast, Alpha rewards distributed to miners, validators, and subnet owners do not halve and will remain constant. In simple terms, Alpha pool injections decrease with TAO, but participant Alpha rewards stay unchanged.
+
+## Summary
+
+- TAO halving reduces emission rate by 50% at supply-based thresholds
+- Timing depends on total issuance, not block numbers
+- Recycling can delay halving events
+- TAO emissions and Alpha pool injections halve; Alpha participant rewards remain constant
+- Current daily emission: ~7,200 TAO → ~3,600 TAO after first halving

docs/learn/announcements.md

@@ -6,9 +6,15 @@ title: "Announcements and Developments"
 
 This page tracks recent and upcoming changes to the Bittensor protocol and other major events in the Bittensor ecosystem.
 
+## Upcoming TAO halving
+
+The first TAO halving event is approaching, which will reduce block rewards by 50%—0.5 TAO per block. This change means less liquidity will be injected each block into the subnet pools. For more information, see the [TAO halving documentation](../concepts/halving.md).
+
+You can track the halving schedule and countdown on the [tao.app explorer](https://tao.app/halving), which provides real-time block data and the estimated time remaining until the reward reduction occurs.
+
 ## Root claim
 
-**Status**: Implemented (on Testnet)
+**Status**: Implemented
 
 - **What**: Root claim replaces the automatic selling of root-alpha dividends and allows users to either accumulate their alpha dividends or enable autosell to sell them off immediately.
 - **Key Features**:
@@ -19,7 +25,7 @@ This page tracks recent and upcoming changes to the Bittensor protocol and other
 
 ## Bittensor SDK v10
 
-**Status**: Pre-release (Bittensor SDK v10.0.0rc2)
+**Status**: Releases
 
 - **What**: A new major version of the Bittensor SDK is in development and will introduce breaking changes.
 - **Key Features**:

sidebars.js

@@ -49,10 +49,8 @@ const sidebars = {
         "resources/questions-and-answers",
         "subnets/understanding-subnets",
         "learn/anatomy-of-incentive-mechanism",
-
         "subnets/understanding-multiple-mech-subnets",
         "learn/neurons",
-
         "learn/emissions",
         "learn/ema",
         "learn/yuma-consensus",
@@ -91,11 +89,11 @@ const sidebars = {
           type: "category",
           label: "Proxies",
           collapsible: true,
-          collapsed: true,          
+          collapsed: true,
           items: [
-          "keys/proxies/index",
-          "keys/proxies/working-with-proxies",
-          "keys/proxies/pure-proxies",
+            "keys/proxies/index",
+            "keys/proxies/working-with-proxies",
+            "keys/proxies/pure-proxies",
           ],
         },
         "keys/multisig",
@@ -231,6 +229,7 @@ const sidebars = {
       collapsed: true,
       items: [
         "concepts/bittensor-networks",
+        "concepts/halving",
         "sdk/mev-protection",
         "concepts/commit-reveal",
         "concepts/consensus-based-weights",