diff --git a/bittensor_cli/cli.py b/bittensor_cli/cli.py index 06ec33755..5c2ddf725 100755 --- a/bittensor_cli/cli.py +++ b/bittensor_cli/cli.py @@ -8323,9 +8323,19 @@ def proxy_create( json_output: bool = Options.json_output, ): """ - TODO ask someone else to write the docs + Creates a new pure proxy account. The pure proxy account is a keyless account controlled by your wallet. + + [bold]Note[/bold]: The proxy account has no private key and cannot sign transactions independently. + All operations must be initiated and signed by the delegator. + + + [bold]Common Examples:[/bold] + 1. Create a pure proxy account + [green]$[/green] btcli proxy create --proxy-type Any + + 2. Create a delayed pure proxy account + [green]$[/green] btcli proxy create --proxy-type Any --delay 1000 - Creates a pure proxy """ self.verbosity_handler(quiet, verbose, json_output, prompt) wallet = self.wallet_ask( @@ -8388,8 +8398,18 @@ def proxy_add( verbose: bool = Options.verbose, json_output: bool = Options.json_output, ): - """ - Adds a proxy + """ + Registers an existing account as a standard proxy for the delegator. + + Grants an existing account permission to execute transactions on your behalf with + specified restrictions. + + [bold]Common Examples:[/bold] + 1. Create a standard proxy account + [green]$[/green] btcli proxy add --delegate 5GDeleg... --proxy-type SmallTransfer + + 2. Create a delayed standard proxy account + [green]$[/green] btcli proxy add --delegate 5GDeleg... --proxy-type Transfer --delay 500 """ logger.debug( @@ -8451,7 +8471,20 @@ def proxy_remove( json_output: bool = Options.json_output, ): """ - Removes a proxy + Unregisters a proxy from an account. + + Revokes proxy permissions previously granted to another account. This prevents the delegate account from executing any further transactions on your behalf. + + [bold]Note[/bold]: You can specify a delegate to remove a single proxy or use the `--all` flag to remove all existing proxies linked to an account. + + + [bold]Common Examples:[/bold] + 1. Revoke proxy permissions from a single proxy account + [green]$[/green] btcli proxy remove --delegate 5GDel... --proxy-type Transfer + + 2. Remove all proxies linked to an account + [green]$[/green] btcli proxy remove --all + """ # TODO should add a --all flag to call Proxy.remove_proxies ? logger.debug( @@ -8521,8 +8554,15 @@ def proxy_kill( json_output: bool = Options.json_output, ): """ + Permanently removes a pure proxy account. + + Once killed, the pure proxy account is cleared from chain storage and cannot be recovered. + + [bold]⚠️ WARNING[/bold]: Killing a pure proxy permanently removes access to the account, and any funds remaining in it are lost. + + EXAMPLE - Kills a pure proxy + [green]$[/green] btcli proxy kill --height 6345834 --index 3 --proxy-type Any --spawner 5x34SPAWN... --proxy 5CCProxy... """ logger.debug( "args:\n"