Merge pull request #499 from opentensor/release/9.6.0

Release/9.6.0

Author: thewhaleking

CHANGELOG.md

@@ -1,6 +1,25 @@
 # Changelog
 
+## 9.6.0/2025-06-12
+
+## What's Changed
+* Allows for staking to multiple netuids in one btcli command by @thewhaleking in https://github.com/opentensor/btcli/pull/481
+* improve stake add json output by @thewhaleking in https://github.com/opentensor/btcli/pull/482
+* Apply bittensor error formatting to btcli by @thewhaleking in https://github.com/opentensor/btcli/pull/483
+* Add Yuma3 Enabled for Sudo Set/Get by @thewhaleking in https://github.com/opentensor/btcli/pull/487
+* Adds `alpha_sigmoid_steepness` call for hyperparams set/get by @thewhaleking in https://github.com/opentensor/btcli/pull/488
+* unstaking test fix by @thewhaleking in https://github.com/opentensor/btcli/pull/489
+* Merge issue: 488 by @thewhaleking in https://github.com/opentensor/btcli/pull/490
+* subnets check-start formatting blocks by @thewhaleking in https://github.com/opentensor/btcli/pull/491
+* Str vs Tuple by @thewhaleking in https://github.com/opentensor/btcli/pull/492
+* Add Homebrew Install to README by @thewhaleking in https://github.com/opentensor/btcli/pull/493
+* Update staking test for new subtensor by @thewhaleking in https://github.com/opentensor/btcli/pull/494
+
+
+**Full Changelog**: https://github.com/opentensor/btcli/compare/v9.5.1...v9.6.0
+
 ## 9.5.1 /2025-06-02
+
 ## What's Changed
 * Declare templates in MANIFEST and include package data by @thewhaleking in https://github.com/opentensor/btcli/pull/477
 

README.md

@@ -38,10 +38,10 @@ Installation steps are described below. For a full documentation on how to use `
 
 ## Install on macOS and Linux
 
-You can install `btcli` on your local machine directly from source, or from PyPI. **Make sure you verify your installation after you install**:
+You can install `btcli` on your local machine directly from source, PyPI, or Homebrew. **Make sure you verify your installation after you install**:
 
 
-### Install from PyPI
+### Install from [PyPI](https://pypi.org/project/bittensor/)
 
 Run 
 ```
@@ -53,6 +53,12 @@ Alternatively, if you prefer to use [uv](https://pypi.org/project/uv/):
 uv pip install bittensor-cli
 ```
 
+### Install from [Homebrew](https://formulae.brew.sh/formula/btcli#default)
+
+```shell
+brew install btcli
+```
+
 ### Install from source
 
 1. Create and activate a virtual environment.

bittensor_cli/cli.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 import asyncio
 import curses
+import copy
 import importlib
 import json
 import os.path
@@ -10,7 +11,7 @@
 import traceback
 import warnings
 from pathlib import Path
-from typing import Coroutine, Optional
+from typing import Coroutine, Optional, Union
 from dataclasses import fields
 
 import rich
@@ -89,6 +90,23 @@ class Options:
     Re-usable typer args
     """
 
+    @classmethod
+    def edit_help(cls, option_name: str, help_text: str):
+        """
+        Edits the `help` attribute of a copied given Typer option in this class, returning
+        the modified Typer option.
+
+        Args:
+            option_name: the name of the option (e.g. "wallet_name")
+            help_text: New help text to be used (e.g. "Wallet's name")
+
+        Returns:
+            Modified Typer Option with new help text.
+        """
+        copied_attr = copy.copy(getattr(cls, option_name))
+        setattr(copied_attr, "help", help_text)
+        return copied_attr
+
     wallet_name = typer.Option(
         None,
         "--wallet-name",
@@ -3202,7 +3220,11 @@ def stake_add(
             help="When set, this command stakes to all hotkeys associated with the wallet. Do not use if specifying "
             "hotkeys in `--include-hotkeys`.",
         ),
-        netuid: Optional[int] = Options.netuid_not_req,
+        netuids: Optional[str] = Options.edit_help(
+            "netuids",
+            "Netuid(s) to for which to add stake. Specify multiple netuids by separating with a comma, e.g."
+            "`btcli st add -n 1,2,3",
+        ),
         all_netuids: bool = Options.all_netuids,
         wallet_name: str = Options.wallet_name,
         wallet_path: str = Options.wallet_path,
@@ -3242,52 +3264,76 @@ def stake_add(
         6. Stake all balance to a subnet:
             [green]$[/green] btcli stake add --all --netuid 3
 
+        7. Stake the same amount to multiple subnets:
+            [green]$[/green] btcli stake add --amount 100 --netuids 4,5,6
+
         [bold]Safe Staking Parameters:[/bold]
         • [blue]--safe[/blue]: Enables rate tolerance checks
         • [blue]--tolerance[/blue]: Maximum % rate change allowed (0.05 = 5%)
         • [blue]--partial[/blue]: Complete partial stake if rates exceed tolerance
 
         """
+        netuids = netuids or []
         self.verbosity_handler(quiet, verbose, json_output)
         safe_staking = self.ask_safe_staking(safe_staking)
         if safe_staking:
             rate_tolerance = self.ask_rate_tolerance(rate_tolerance)
             allow_partial_stake = self.ask_partial_stake(allow_partial_stake)
             console.print("\n")
-        netuid = get_optional_netuid(netuid, all_netuids)
+
+        if netuids:
+            netuids = parse_to_list(
+                netuids, int, "Netuids must be ints separated by commas", False
+            )
+        else:
+            netuid_ = get_optional_netuid(None, all_netuids)
+            netuids = [netuid_] if netuid_ else None
+        if netuids:
+            for netuid_ in netuids:
+                # ensure no negative netuids make it into our list
+                validate_netuid(netuid_)
 
         if stake_all and amount:
             print_error(
                 "Cannot specify an amount and 'stake-all'. Choose one or the other."
             )
-            raise typer.Exit()
+            return
 
         if stake_all and not amount:
             if not Confirm.ask("Stake all the available TAO tokens?", default=False):
-                raise typer.Exit()
+                return
+
+        if (
+            stake_all
+            and (isinstance(netuids, list) and len(netuids) > 1)
+            or (netuids is None)
+        ):
+            print_error("Cannot stake all to multiple subnets.")
+            return
 
         if all_hotkeys and include_hotkeys:
             print_error(
                 "You have specified hotkeys to include and also the `--all-hotkeys` flag. The flag"
                 "should only be used standalone (to use all hotkeys) or with `--exclude-hotkeys`."
             )
-            raise typer.Exit()
+            return
 
         if include_hotkeys and exclude_hotkeys:
             print_error(
                 "You have specified options for both including and excluding hotkeys. Select one or the other."
             )
-            raise typer.Exit()
+            return
 
         if not wallet_hotkey and not all_hotkeys and not include_hotkeys:
             if not wallet_name:
                 wallet_name = Prompt.ask(
                     "Enter the [blue]wallet name[/blue]",
                     default=self.config.get("wallet_name") or defaults.wallet.name,
                 )
-            if netuid is not None:
+            if netuids is not None:
                 hotkey_or_ss58 = Prompt.ask(
-                    "Enter the [blue]wallet hotkey[/blue] name or [blue]ss58 address[/blue] to stake to [dim](or Press Enter to view delegates)[/dim]",
+                    "Enter the [blue]wallet hotkey[/blue] name or [blue]ss58 address[/blue] to stake to [dim]"
+                    "(or Press Enter to view delegates)[/dim]",
                 )
             else:
                 hotkey_or_ss58 = Prompt.ask(
@@ -3299,10 +3345,18 @@ def stake_add(
                 wallet = self.wallet_ask(
                     wallet_name, wallet_path, wallet_hotkey, ask_for=[WO.NAME, WO.PATH]
                 )
+                if len(netuids) > 1:
+                    netuid_ = IntPrompt.ask(
+                        "Enter the netuid for which to show delegates",
+                        choices=[str(x) for x in netuids],
+                    )
+                else:
+                    netuid_ = netuids[0]
+
                 selected_hotkey = self._run_command(
                     subnets.show(
                         subtensor=self.initialize_chain(network),
-                        netuid=netuid,
+                        netuid=netuid_,
                         sort=False,
                         max_rows=12,
                         prompt=False,
@@ -3312,7 +3366,7 @@ def stake_add(
                 )
                 if not selected_hotkey:
                     print_error("No delegate selected. Exiting.")
-                    raise typer.Exit()
+                    return
                 include_hotkeys = selected_hotkey
             elif is_valid_ss58_address(hotkey_or_ss58):
                 wallet = self.wallet_ask(
@@ -3373,8 +3427,8 @@ def stake_add(
             )
             if free_balance == Balance.from_tao(0):
                 print_error("You dont have any balance to stake.")
-                raise typer.Exit()
-            if netuid is not None:
+                return
+            if netuids:
                 amount = FloatPrompt.ask(
                     f"Amount to [{COLORS.G.SUBHEAD_MAIN}]stake (TAO τ)"
                 )
@@ -3396,7 +3450,7 @@ def stake_add(
             add_stake.stake_add(
                 wallet,
                 self.initialize_chain(network),
-                netuid,
+                netuids,
                 stake_all,
                 amount,
                 prompt,
@@ -4796,12 +4850,9 @@ def subnets_list(
     def subnets_price(
         self,
         network: Optional[list[str]] = Options.network,
-        netuids: str = typer.Option(
-            None,
-            "--netuids",
-            "--netuid",
-            "-n",
-            help="Netuid(s) to show the price for.",
+        netuids: str = Options.edit_help(
+            "netuids",
+            "Netuids to show the price for. Separate multiple netuids with a comma, for example: `-n 0,1,2`.",
         ),
         interval_hours: int = typer.Option(
             24,

bittensor_cli/src/__init__.py

@@ -658,6 +658,8 @@ class WalletValidationTypes(Enum):
         "sudo_set_network_pow_registration_allowed",
         False,
     ),
+    "yuma3_enabled": ("sudo_set_yuma3_enabled", False),
+    "alpha_sigmoid_steepness": ("sudo_set_alpha_sigmoid_steepness", True),
 }
 
 # Help Panels for cli help

bittensor_cli/src/bittensor/chain_data.py

@@ -177,6 +177,8 @@ class SubnetHyperparameters(InfoBase):
     alpha_high: int
     alpha_low: int
     liquid_alpha_enabled: bool
+    yuma3_enabled: bool
+    alpha_sigmoid_steepness: int
 
     @classmethod
     def _fix_decoded(
@@ -210,6 +212,8 @@ def _fix_decoded(
             alpha_high=decoded.get("alpha_high"),
             alpha_low=decoded.get("alpha_low"),
             liquid_alpha_enabled=decoded.get("liquid_alpha_enabled"),
+            yuma3_enabled=decoded.get("yuma3_enabled"),
+            alpha_sigmoid_steepness=decoded.get("alpha_sigmoid_steepness"),
         )
 
 

bittensor_cli/src/bittensor/subtensor_interface.py

@@ -1128,14 +1128,22 @@ async def get_subnet_hyperparameters(
         Understanding the hyperparameters is crucial for comprehending how subnets are configured and
         managed, and how they interact with the network's consensus and incentive mechanisms.
         """
-        result = await self.query_runtime_api(
-            runtime_api="SubnetInfoRuntimeApi",
-            method="get_subnet_hyperparams",
-            params=[netuid],
-            block_hash=block_hash,
+        main_result, yuma3_result, sigmoid_steepness = await asyncio.gather(
+            self.query_runtime_api(
+                runtime_api="SubnetInfoRuntimeApi",
+                method="get_subnet_hyperparams",
+                params=[netuid],
+                block_hash=block_hash,
+            ),
+            self.query("SubtensorModule", "Yuma3On", [netuid]),
+            self.query("SubtensorModule", "AlphaSigmoidSteepness", [netuid]),
         )
-
-        if not result:
+        result = {
+            **main_result,
+            **{"yuma3_enabled": yuma3_result},
+            **{"alpha_sigmoid_steepness": sigmoid_steepness},
+        }
+        if not main_result:
             return []
 
         return SubnetHyperparameters.from_any(result)