Merge branch 'staging' into fix/zyzniewski/test_incentive

Author: zyzniewski-reef

.github/workflows/e2e-subtensor-tests.yaml

@@ -6,10 +6,10 @@ concurrency:
 
 on:
   push:
-    branches: [main, development, staging]
+    branches: [master, development, staging]
 
   pull_request:
-    branches: [main, development, staging]
+    branches: [master, development, staging]
     types: [ opened, synchronize, reopened, ready_for_review ]
 
   workflow_dispatch:

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 9.0.5 /2025-03-12
+## 9.1.0 /2025-03-12
 
 ## What's Changed
 * Refactor duplicated unittests code by @zyzniewski-reef in https://github.com/opentensor/bittensor/pull/2724
@@ -12,8 +12,13 @@
 * All metagraph subtensor methods now use block by @thewhaleking in https://github.com/opentensor/bittensor/pull/2738
 * Tests: increse test_incentive timeout + fix sudo_set_weights_set_rate_limit by @zyzniewski-reef in https://github.com/opentensor/bittensor/pull/2739
 * Feat/safe staking by @ibraheem-opentensor in https://github.com/opentensor/bittensor/pull/2736
+* 9.0.5: Bumps version and changelog by @ibraheem-opentensor in https://github.com/opentensor/bittensor/pull/2741
+* Tests: enable E2E test_batch_operations by @zyzniewski-reef in https://github.com/opentensor/bittensor/pull/2744
+* Fix: burned_register supports root subnet (netuid=0 param) by @zyzniewski-reef in https://github.com/opentensor/bittensor/pull/2732
+* Feat: set_delegate_take by @zyzniewski-reef in https://github.com/opentensor/bittensor/pull/2731
+* Renames rate_threshold -> rate_tolerance by @ibraheem-opentensor in https://github.com/opentensor/bittensor/pull/2745
 
-**Full Changelog**: https://github.com/opentensor/bittensor/compare/v9.0.4...v9.0.5
+**Full Changelog**: https://github.com/opentensor/bittensor/compare/v9.0.4...v9.1.0
 
 ## 9.0.4 /2025-03-06
 

VERSION

@@ -1 +1 @@
-9.0.5
+9.1.0

bittensor/core/async_subtensor.py

@@ -2821,7 +2821,7 @@ async def add_stake(
         wait_for_finalization: bool = False,
         safe_staking: bool = False,
         allow_partial_stake: bool = False,
-        rate_threshold: float = 0.005,
+        rate_tolerance: float = 0.005,
     ) -> bool:
         """
         Adds the specified amount of stake to a neuron identified by the hotkey ``SS58`` address.
@@ -2836,11 +2836,11 @@ async def add_stake(
             wait_for_inclusion (bool): Waits for the transaction to be included in a block.
             wait_for_finalization (bool): Waits for the transaction to be finalized on the blockchain.
             safe_staking (bool): If true, enables price safety checks to protect against fluctuating prices. The stake
-                will only execute if the price change doesn't exceed the rate threshold. Default is False.
+                will only execute if the price change doesn't exceed the rate tolerance. Default is False.
             allow_partial_stake (bool): If true and safe_staking is enabled, allows partial staking when
                 the full amount would exceed the price threshold. If false, the entire stake fails if it would
                 exceed the threshold. Default is False.
-            rate_threshold (float): The maximum allowed price change ratio when staking. For example,
+            rate_tolerance (float): The maximum allowed price change ratio when staking. For example,
                 0.005 = 0.5% maximum price increase. Only used when safe_staking is True. Default is 0.005.
 
         Returns:
@@ -2861,7 +2861,7 @@ async def add_stake(
             wait_for_finalization=wait_for_finalization,
             safe_staking=safe_staking,
             allow_partial_stake=allow_partial_stake,
-            rate_threshold=rate_threshold,
+            rate_tolerance=rate_tolerance,
         )
 
     async def add_stake_multiple(
@@ -3540,7 +3540,7 @@ async def swap_stake(
         wait_for_finalization: bool = False,
         safe_staking: bool = False,
         allow_partial_stake: bool = False,
-        rate_threshold: float = 0.005,
+        rate_tolerance: float = 0.005,
     ) -> bool:
         """
         Moves stake between subnets while keeping the same coldkey-hotkey pair ownership.
@@ -3555,12 +3555,12 @@ async def swap_stake(
             wait_for_inclusion (bool): Waits for the transaction to be included in a block.
             wait_for_finalization (bool): Waits for the transaction to be finalized on the blockchain.
             safe_staking (bool): If true, enables price safety checks to protect against fluctuating prices. The swap
-                will only execute if the price ratio between subnets doesn't exceed the rate threshold.
+                will only execute if the price ratio between subnets doesn't exceed the rate tolerance.
                 Default is False.
             allow_partial_stake (bool): If true and safe_staking is enabled, allows partial stake swaps when
                 the full amount would exceed the price threshold. If false, the entire swap fails if it would
                 exceed the threshold. Default is False.
-            rate_threshold (float): The maximum allowed increase in the price ratio between subnets
+            rate_tolerance (float): The maximum allowed increase in the price ratio between subnets
                 (origin_price/destination_price). For example, 0.005 = 0.5% maximum increase. Only used
                 when safe_staking is True. Default is 0.005.
 
@@ -3570,9 +3570,9 @@ async def swap_stake(
         The price ratio for swap_stake in safe mode is calculated as: origin_subnet_price / destination_subnet_price
         When safe_staking is enabled, the swap will only execute if:
             - With allow_partial_stake=False: The entire swap amount can be executed without the price ratio
-            increasing more than rate_threshold
+            increasing more than rate_tolerance
             - With allow_partial_stake=True: A partial amount will be swapped up to the point where the
-            price ratio would increase by rate_threshold
+            price ratio would increase by rate_tolerance
         """
         amount = check_and_convert_to_balance(amount)
         return await swap_stake_extrinsic(
@@ -3586,7 +3586,7 @@ async def swap_stake(
             wait_for_finalization=wait_for_finalization,
             safe_staking=safe_staking,
             allow_partial_stake=allow_partial_stake,
-            rate_threshold=rate_threshold,
+            rate_tolerance=rate_tolerance,
         )
 
     async def transfer_stake(
@@ -3677,7 +3677,7 @@ async def unstake(
         wait_for_finalization: bool = False,
         safe_staking: bool = False,
         allow_partial_stake: bool = False,
-        rate_threshold: float = 0.005,
+        rate_tolerance: float = 0.005,
     ) -> bool:
         """
         Removes a specified amount of stake from a single hotkey account. This function is critical for adjusting
@@ -3692,11 +3692,11 @@ async def unstake(
             wait_for_inclusion (bool): Waits for the transaction to be included in a block.
             wait_for_finalization (bool): Waits for the transaction to be finalized on the blockchain.
             safe_staking (bool): If true, enables price safety checks to protect against fluctuating prices. The unstake
-                will only execute if the price change doesn't exceed the rate threshold. Default is False.
+                will only execute if the price change doesn't exceed the rate tolerance. Default is False.
             allow_partial_stake (bool): If true and safe_staking is enabled, allows partial unstaking when
                 the full amount would exceed the price threshold. If false, the entire unstake fails if it would
                 exceed the threshold. Default is False.
-            rate_threshold (float): The maximum allowed price change ratio when unstaking. For example,
+            rate_tolerance (float): The maximum allowed price change ratio when unstaking. For example,
                 0.005 = 0.5% maximum price decrease. Only used when safe_staking is True. Default is 0.005.
 
         Returns:
@@ -3716,7 +3716,7 @@ async def unstake(
             wait_for_finalization=wait_for_finalization,
             safe_staking=safe_staking,
             allow_partial_stake=allow_partial_stake,
-            rate_threshold=rate_threshold,
+            rate_tolerance=rate_tolerance,
         )
 
     async def unstake_multiple(

bittensor/core/extrinsics/asyncex/move_stake.py

@@ -162,7 +162,7 @@ async def swap_stake_extrinsic(
     wait_for_finalization: bool = False,
     safe_staking: bool = False,
     allow_partial_stake: bool = False,
-    rate_threshold: float = 0.005,
+    rate_tolerance: float = 0.005,
 ) -> bool:
     """
     Swaps stake from one subnet to another for a given hotkey in the Bittensor network.
@@ -177,8 +177,8 @@ async def swap_stake_extrinsic(
         wait_for_inclusion (bool): If True, waits for transaction inclusion in a block. Defaults to True.
         wait_for_finalization (bool): If True, waits for transaction finalization. Defaults to False.
         safe_staking (bool): If true, enables price safety checks to protect against price impact.
-        allow_partial_stake (bool): If true, allows partial stake swaps when the full amount would exceed the price threshold.
-        rate_threshold (float): Maximum allowed increase in price ratio (0.005 = 0.5%).
+        allow_partial_stake (bool): If true, allows partial stake swaps when the full amount would exceed the price tolerance.
+        rate_tolerance (float): Maximum allowed increase in price ratio (0.005 = 0.5%).
 
     Returns:
         bool: True if the swap was successful, False otherwise.
@@ -224,7 +224,7 @@ async def swap_stake_extrinsic(
                 subtensor.subnet(netuid=destination_netuid),
             )
             swap_rate_ratio = origin_pool.price.rao / destination_pool.price.rao
-            swap_rate_ratio_with_tolerance = swap_rate_ratio * (1 + rate_threshold)
+            swap_rate_ratio_with_tolerance = swap_rate_ratio * (1 + rate_tolerance)
 
             logging.info(
                 f"Swapping stake with safety for hotkey [blue]{hotkey_ss58}[/blue]\n"

bittensor/core/extrinsics/asyncex/staking.py

@@ -23,7 +23,7 @@ async def add_stake_extrinsic(
     wait_for_finalization: bool = False,
     safe_staking: bool = False,
     allow_partial_stake: bool = False,
-    rate_threshold: float = 0.005,
+    rate_tolerance: float = 0.005,
 ) -> bool:
     """
     Adds the specified amount of stake to passed hotkey `uid`.
@@ -41,7 +41,7 @@ async def add_stake_extrinsic(
             or returns `False` if the extrinsic fails to be finalized within the timeout.
         safe_staking: If set, uses safe staking logic
         allow_partial_stake: If set, allows partial stake
-        rate_threshold: The rate threshold for safe staking
+        rate_tolerance: The rate tolerance for safe staking
 
     Returns:
         success: Flag is `True` if extrinsic was finalized or included in the block. If we did not wait for
@@ -112,7 +112,7 @@ async def add_stake_extrinsic(
         if safe_staking:
             pool = await subtensor.subnet(netuid=netuid)
             base_price = pool.price.rao
-            price_with_tolerance = base_price * (1 + rate_threshold)
+            price_with_tolerance = base_price * (1 + rate_tolerance)
             call_params.update(
                 {
                     "limit_price": price_with_tolerance,
@@ -123,11 +123,11 @@ async def add_stake_extrinsic(
 
             # For logging
             base_rate = pool.price.tao
-            rate_with_tolerance = base_rate * (1 + rate_threshold)
+            rate_with_tolerance = base_rate * (1 + rate_tolerance)
             logging.info(
                 f":satellite: [magenta]Safe Staking to:[/magenta] "
                 f"[blue]netuid: [green]{netuid}[/green], amount: [green]{staking_balance}[/green], "
-                f"tolerance percentage: [green]{rate_threshold*100}%[/green], "
+                f"tolerance percentage: [green]{rate_tolerance*100}%[/green], "
                 f"price limit: [green]{rate_with_tolerance}[/green], "
                 f"original price: [green]{base_rate}[/green], "
                 f"with partial stake: [green]{allow_partial_stake}[/green] "

bittensor/core/extrinsics/asyncex/unstaking.py

@@ -22,7 +22,7 @@ async def unstake_extrinsic(
     wait_for_finalization: bool = False,
     safe_staking: bool = False,
     allow_partial_stake: bool = False,
-    rate_threshold: float = 0.005,
+    rate_tolerance: float = 0.005,
 ) -> bool:
     """Removes stake into the wallet coldkey from the specified hotkey ``uid``.
 
@@ -38,8 +38,8 @@ async def unstake_extrinsic(
         wait_for_finalization (bool): If set, waits for the extrinsic to be finalized on the chain before returning
             ``True``, or returns ``False`` if the extrinsic fails to be finalized within the timeout.
         safe_staking: If true, enables price safety checks
-        allow_partial_stake: If true, allows partial unstaking if price threshold exceeded
-        rate_threshold: Maximum allowed price decrease percentage (0.005 = 0.5%)
+        allow_partial_stake: If true, allows partial unstaking if price tolerance exceeded
+        rate_tolerance: Maximum allowed price decrease percentage (0.005 = 0.5%)
 
     Returns:
         success (bool): Flag is ``True`` if extrinsic was finalized or included in the block. If we did not wait for
@@ -97,16 +97,16 @@ async def unstake_extrinsic(
         if safe_staking:
             pool = await subtensor.subnet(netuid=netuid)
             base_price = pool.price.rao
-            price_with_tolerance = base_price * (1 - rate_threshold)
+            price_with_tolerance = base_price * (1 - rate_tolerance)
 
             # For logging
             base_rate = pool.price.tao
-            rate_with_tolerance = base_rate * (1 - rate_threshold)
+            rate_with_tolerance = base_rate * (1 - rate_tolerance)
 
             logging.info(
                 f":satellite: [magenta]Safe Unstaking from:[/magenta] "
                 f"netuid: [green]{netuid}[/green], amount: [green]{unstaking_balance}[/green], "
-                f"tolerance percentage: [green]{rate_threshold*100}%[/green], "
+                f"tolerance percentage: [green]{rate_tolerance*100}%[/green], "
                 f"price limit: [green]{rate_with_tolerance}[/green], "
                 f"original price: [green]{base_rate}[/green], "
                 f"with partial unstake: [green]{allow_partial_stake}[/green] "

bittensor/core/extrinsics/move_stake.py

@@ -159,7 +159,7 @@ def swap_stake_extrinsic(
     wait_for_finalization: bool = False,
     safe_staking: bool = False,
     allow_partial_stake: bool = False,
-    rate_threshold: float = 0.005,
+    rate_tolerance: float = 0.005,
 ) -> bool:
     """
     Moves stake between subnets while keeping the same coldkey-hotkey pair ownership.
@@ -174,8 +174,8 @@ def swap_stake_extrinsic(
         wait_for_inclusion (bool): If true, waits for inclusion before returning.
         wait_for_finalization (bool): If true, waits for finalization before returning.
         safe_staking (bool): If true, enables price safety checks to protect against price impact.
-        allow_partial_stake (bool): If true, allows partial stake swaps when the full amount would exceed the price threshold.
-        rate_threshold (float): Maximum allowed increase in price ratio (0.005 = 0.5%).
+        allow_partial_stake (bool): If true, allows partial stake swaps when the full amount would exceed the price tolerance.
+        rate_tolerance (float): Maximum allowed increase in price ratio (0.005 = 0.5%).
 
     Returns:
         success (bool): True if the swap was successful.
@@ -220,7 +220,7 @@ def swap_stake_extrinsic(
             origin_pool = subtensor.subnet(netuid=origin_netuid)
             destination_pool = subtensor.subnet(netuid=destination_netuid)
             swap_rate_ratio = origin_pool.price.rao / destination_pool.price.rao
-            swap_rate_ratio_with_tolerance = swap_rate_ratio * (1 + rate_threshold)
+            swap_rate_ratio_with_tolerance = swap_rate_ratio * (1 + rate_tolerance)
 
             logging.info(
                 f"Swapping stake with safety for hotkey [blue]{hotkey_ss58}[/blue]\n"

bittensor/core/extrinsics/staking.py

@@ -21,7 +21,7 @@ def add_stake_extrinsic(
     wait_for_finalization: bool = False,
     safe_staking: bool = False,
     allow_partial_stake: bool = False,
-    rate_threshold: float = 0.005,
+    rate_tolerance: float = 0.005,
 ) -> bool:
     """
     Adds the specified amount of stake to passed hotkey `uid`.
@@ -37,8 +37,8 @@ def add_stake_extrinsic(
         wait_for_finalization: If set, waits for the extrinsic to be finalized on the chain before returning `True`,
             or returns `False` if the extrinsic fails to be finalized within the timeout.
         safe_staking (bool): If true, enables price safety checks
-        allow_partial_stake (bool): If true, allows partial unstaking if price threshold exceeded
-        rate_threshold (float): Maximum allowed price increase percentage (0.005 = 0.5%)
+        allow_partial_stake (bool): If true, allows partial unstaking if price tolerance exceeded
+        rate_tolerance (float): Maximum allowed price increase percentage (0.005 = 0.5%)
 
     Returns:
         success: Flag is `True` if extrinsic was finalized or included in the block. If we did not wait for
@@ -106,16 +106,16 @@ def add_stake_extrinsic(
         if safe_staking:
             pool = subtensor.subnet(netuid=netuid)
             base_price = pool.price.rao
-            price_with_tolerance = base_price * (1 + rate_threshold)
+            price_with_tolerance = base_price * (1 + rate_tolerance)
 
             # For logging
             base_rate = pool.price.tao
-            rate_with_tolerance = base_rate * (1 + rate_threshold)
+            rate_with_tolerance = base_rate * (1 + rate_tolerance)
 
             logging.info(
                 f":satellite: [magenta]Safe Staking to:[/magenta] "
                 f"[blue]netuid: [green]{netuid}[/green], amount: [green]{staking_balance}[/green], "
-                f"tolerance percentage: [green]{rate_threshold*100}%[/green], "
+                f"tolerance percentage: [green]{rate_tolerance*100}%[/green], "
                 f"price limit: [green]{rate_with_tolerance}[/green], "
                 f"original price: [green]{base_rate}[/green], "
                 f"with partial stake: [green]{allow_partial_stake}[/green] "