htcli 1.1.0__py3-none-any.whl

src/htcli/commands/subnet/error_handling.py

@@ -0,0 +1,524 @@
+"""
+Error handling utilities for subnet commands.
+Provides user-friendly error messages for all subnet-related errors.
+"""
+
+from typing import Optional
+
+from ...ui.components import HTCLIPanel
+from ...ui.display import HTCLIConsole
+
+
+def handle_subnet_error(
+    error_msg: str,
+    subnet_id: Optional[int] = None,
+    operation: str = "operation",
+    client=None,
+) -> bool:
+    """
+    Handle subnet-related errors with user-friendly messages.
+
+    Args:
+        error_msg: The error message from the blockchain
+        subnet_id: The subnet ID (if applicable)
+        operation: Description of the operation being performed
+        client: Optional client instance for fetching additional info
+
+    Returns:
+        bool: True if error was handled, False otherwise
+    """
+    console = HTCLIConsole()
+    subnet_id_str = f" {subnet_id}" if subnet_id is not None else ""
+    
+    # System-level errors (checked first)
+    if "Paused" in error_msg and "Subnet" not in error_msg:
+        error_panel = HTCLIPanel(
+            f"The network is currently paused.\n\n"
+            f"⏸️  All transactions are temporarily disabled on the network.\n\n"
+            f"💡 Please wait for the network to resume operations.\n"
+            f"   Check network status or try again later.",
+            title="⏸️  Network Paused",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+    
+    elif "BadOrigin" in error_msg or ("invalid" in error_msg.lower() and "signature" in error_msg.lower()):
+        error_panel = HTCLIPanel(
+            f"Invalid transaction signature.\n\n"
+            f"💡 This usually means:\n"
+            f"   - Your wallet is not properly unlocked\n"
+            f"   - The signing key doesn't match the account\n"
+            f"   - There's an issue with your wallet configuration\n\n"
+            f"   Try: htcli wallet unlock to unlock your wallet\n"
+            f"   Or check your wallet configuration: htcli wallet list",
+            title="❌ Invalid Signature",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+    
+    elif "TxRateLimitExceeded" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Transaction rate limit exceeded.\n\n"
+            f"⏱️  You've exceeded the maximum number of transactions allowed for your account.\n\n"
+            f"💡 Wait a moment before submitting another transaction.\n"
+            f"   Rate limits help prevent spam and ensure network stability.",
+            title="⏳ Rate Limit Exceeded",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+    
+    # Common errors that apply to most operations
+    elif "NotSubnetOwner" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Only the subnet owner can perform this {operation} on subnet{subnet_id_str}.\n\n"
+            f"💡 Make sure you're using the coldkey wallet that owns this subnet.\n"
+            f"   Use: htcli subnet info --subnet-id{subnet_id_str} to check the owner",
+            title="❌ Permission Denied",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidSubnetId" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} does not exist.\n\n"
+            f"💡 Check the subnet ID and try again.\n"
+            f"   Use: htcli subnet list to see available subnets",
+            title="❌ Invalid Subnet ID",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Pause-specific errors
+    elif "SubnetMustBeActive" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} must be active to pause it.\n\n"
+            f"💡 Only active subnets can be paused.\n"
+            f"   Use: htcli subnet info --subnet-id{subnet_id_str} to check subnet status",
+            title="⚠️  Subnet Not Active",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "SubnetPauseCooldownActive" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} cannot be paused yet due to cooldown period.\n\n"
+            f"⏱️  Subnets have a cooldown period after unpausing before they can be paused again.\n\n"
+            f"💡 Wait for the cooldown period to expire and try again.",
+            title="⏳ Pause Cooldown Active",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Unpause-specific errors
+    elif "SubnetMustBePaused" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} must be paused to {operation}.\n\n"
+            f"💡 This action requires the subnet to be in a Paused state.\n"
+            f"   Use: htcli subnet pause --subnet-id{subnet_id_str} to pause it first",
+            title="⚠️  Subnet Not Paused",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Update name/repo errors
+    elif "SubnetNameExist" in error_msg:
+        error_panel = HTCLIPanel(
+            f"This subnet name is already taken by another subnet.\n\n"
+            f"💡 Subnet names must be unique across the network.\n"
+            f"   Choose a different name and try again.",
+            title="❌ Name Already Exists",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "SubnetRepoExist" in error_msg:
+        error_panel = HTCLIPanel(
+            f"This repository URL is already registered to another subnet.\n\n"
+            f"💡 Repository URLs must be unique across the network.\n"
+            f"   Use a different repository URL and try again.",
+            title="❌ Repository Already Exists",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Transfer ownership errors
+    elif "NoPendingSubnetOwner" in error_msg:
+        error_panel = HTCLIPanel(
+            f"No pending ownership transfer exists for subnet{subnet_id_str}.\n\n"
+            f"💡 Ownership transfer is a 2-step process:\n"
+            f"   1. Current owner initiates transfer: htcli subnet transfer --subnet-id{subnet_id_str} --new-owner <address>\n"
+            f"   2. New owner accepts: htcli subnet accept --subnet-id{subnet_id_str}\n\n"
+            f"   Make sure step 1 was completed first.",
+            title="❌ No Pending Transfer",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "NotPendingSubnetOwner" in error_msg:
+        error_panel = HTCLIPanel(
+            f"You are not the pending owner for subnet{subnet_id_str}.\n\n"
+            f"💡 Only the address specified in the ownership transfer can accept it.\n"
+            f"   Make sure you're using the correct coldkey wallet.",
+            title="❌ Not Pending Owner",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Configuration update errors
+    elif "InvalidChurnLimit" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid churn limit value.\n\n"
+            f"💡 Churn limit must be within the allowed range (MinChurnLimit to MaxChurnLimit).\n"
+            f"   Check the network parameters for valid values.",
+            title="❌ Invalid Churn Limit",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidRegistrationQueueEpochs" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid registration queue epochs value.\n\n"
+            f"💡 Registration queue epochs must be within the allowed range.\n"
+            f"   Check the network parameters for valid values.",
+            title="❌ Invalid Queue Epochs",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidIdleClassificationEpochs" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid idle classification epochs value.\n\n"
+            f"💡 Idle classification epochs must be within the allowed range.\n"
+            f"   Check the network parameters for valid values.",
+            title="❌ Invalid Idle Epochs",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidIncludedClassificationEpochs" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid included classification epochs value.\n\n"
+            f"💡 Included classification epochs must be within the allowed range.\n"
+            f"   Check the network parameters for valid values.",
+            title="❌ Invalid Included Epochs",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidMaxRegisteredNodes" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid max registered nodes value.\n\n"
+            f"💡 Max registered nodes must be between 1 and 64.\n"
+            f"   The blockchain enforces a maximum of 64 nodes.",
+            title="❌ Invalid Max Nodes",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidMaxSubnetNodePenalties" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid max node penalties value.\n\n"
+            f"💡 Max node penalties must be within the allowed range.\n"
+            f"   Check MinMaxSubnetNodePenalties and MaxMaxSubnetNodePenalties parameters.",
+            title="❌ Invalid Max Penalties",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidSubnetMinStake" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid minimum stake value.\n\n"
+            f"💡 Minimum stake must be between 100-250 TENSOR.\n"
+            f"   Check the network parameters for valid values.",
+            title="❌ Invalid Min Stake",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidSubnetMaxStake" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid maximum stake value.\n\n"
+            f"💡 Maximum stake must be ≤ 1000 TENSOR (NetworkMaxStakeBalance).\n"
+            f"   Use a lower value and try again.",
+            title="❌ Invalid Max Stake",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidSubnetStakeParameters" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid stake parameters.\n\n"
+            f"💡 Minimum stake must be less than or equal to maximum stake.\n"
+            f"   Adjust your stake parameters to satisfy: min_stake ≤ max_stake",
+            title="❌ Invalid Stake Parameters",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif (
+        "InvalidDelegateStakePercentage" in error_msg
+        or "InvalidMinDelegateStakePercentage" in error_msg
+    ):
+        error_panel = HTCLIPanel(
+            f"Invalid delegate stake percentage.\n\n"
+            f"💡 Delegate stake percentage must be between 5% and 95%.\n"
+            f"   Use a value in this range (e.g., 20 for 20%).",
+            title="❌ Invalid Delegate Percentage",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "DelegateStakePercentageUpdateTooSoon" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Cannot update delegate stake percentage yet.\n\n"
+            f"⏱️  There is a cooldown period between delegate stake percentage updates.\n\n"
+            f"💡 Wait for the cooldown period to expire and try again.",
+            title="⏳ Update Cooldown Active",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "DelegateStakePercentageAbsDiffTooLarge" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Delegate stake percentage change is too large.\n\n"
+            f"💡 The change between current and new percentage exceeds the maximum allowed.\n"
+            f"   Make smaller incremental changes instead.",
+            title="❌ Change Too Large",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Network pause errors
+    elif "SubnetIsPaused" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} is paused and cannot perform this action.\n\n"
+            f"💡 The subnet must be unpaused first.\n"
+            f"   Use: htcli subnet unpause --subnet-id{subnet_id_str}",
+            title="⏸️  Subnet Paused",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Registration errors
+    elif "MaxSubnets" in error_msg:
+        error_panel = HTCLIPanel(
+            f"The network has reached maximum subnet capacity.\n\n"
+            f"💡 The network can only support a limited number of subnets.\n"
+            f"   Wait for a subnet slot to become available or check if any subnets can be removed.",
+            title="❌ Network at Capacity",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "BootnodesEmpty" in error_msg:
+        error_panel = HTCLIPanel(
+            f"No bootnodes provided for subnet registration.\n\n"
+            f"💡 At least one bootnode is required for subnet registration.\n"
+            f"   Bootnodes are P2P network entry points for subnet nodes.\n"
+            f"   Provide at least one valid bootnode multiaddr and try again.",
+            title="❌ Bootnodes Required",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "TooManyBootnodes" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Too many bootnodes provided.\n\n"
+            f"💡 The number of bootnodes exceeds the maximum allowed (MaxBootnodes).\n"
+            f"   Reduce the number of bootnodes and try again.",
+            title="❌ Too Many Bootnodes",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "CostGreaterThanMaxCost" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Registration cost exceeds your maximum cost limit.\n\n"
+            f"💡 The current registration cost is higher than the max_cost you specified.\n"
+            f"   This protects you from unexpected cost increases.\n"
+            f"   Increase your max_cost parameter or wait for costs to decrease.",
+            title="❌ Cost Exceeds Maximum",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "NotEnoughBalanceToRegisterSubnet" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Insufficient balance to register subnet.\n\n"
+            f"💡 You don't have enough balance to cover the registration cost.\n"
+            f"   Ensure your wallet has sufficient funds and try again.\n"
+            f"   Check your balance: htcli wallet balance",
+            title="❌ Insufficient Balance",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "NoAvailableSlots" in error_msg:
+        error_panel = HTCLIPanel(
+            f"No epoch slots available for subnet registration.\n\n"
+            f"💡 The network has no available epoch slots for new subnet assignments.\n"
+            f"   Wait for a slot to become available and try again.",
+            title="❌ No Available Slots",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "MustUnstakeToRegister" in error_msg:
+        error_panel = HTCLIPanel(
+            f"You must unstake before registering a subnet.\n\n"
+            f"💡 You have existing stake that must be unstaked before registering a new subnet.\n"
+            f"   Unstake your existing stake first, then try registering again.\n"
+            f"   Use: htcli stake unstake to remove your stake",
+            title="❌ Must Unstake First",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "ColdkeyRegistrationWhitelist" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Your coldkey is not whitelisted for subnet registration.\n\n"
+            f"💡 Subnet registration requires whitelisting when enabled.\n"
+            f"   Contact network administrators to get your coldkey whitelisted.",
+            title="❌ Not Whitelisted",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidSubnetRegistrationInitialColdkeys" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Invalid initial coldkeys configuration.\n\n"
+            f"💡 The initial coldkeys must meet minimum requirements:\n"
+            f"   - Each coldkey must have at least 1 registration slot\n"
+            f"   - Total number of coldkeys must be >= MinSubnetNodes\n"
+            f"   Check your initial_coldkeys configuration and try again.",
+            title="❌ Invalid Initial Coldkeys",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "CouldNotConvertToBalance" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Balance conversion failed.\n\n"
+            f"💡 Failed to convert u128 value to BalanceOf type.\n"
+            f"   This usually indicates an overflow or invalid value.\n"
+            f"   Check your input values and try again.",
+            title="❌ Conversion Error",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Activation errors
+    elif "SubnetActivatedAlready" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} is already activated.\n\n"
+            f"💡 This subnet is already in Active or Paused state.\n"
+            f"   Only subnets in Registered state can be activated.\n"
+            f"   Check subnet status: htcli subnet info --subnet-id{subnet_id_str}",
+            title="⚠️  Already Activated",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "MinSubnetRegistrationEpochsNotMet" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Too early to activate subnet{subnet_id_str}.\n\n"
+            f"⏱️  The minimum registration epochs requirement has not been met yet.\n\n"
+            f"💡 Subnets must wait for MinSubnetRegistrationEpochs after registration\n"
+            f"   before they can attempt activation.\n"
+            f"   Wait for the minimum period to pass and try again.",
+            title="⏳ Too Early to Activate",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "SubnetActivationConditionsNotMetYet" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Subnet{subnet_id_str} activation conditions not met yet.\n\n"
+            f"💡 The subnet is still in the registration period but doesn't meet activation requirements:\n"
+            f"   - Minimum active nodes (MinSubnetNodes)\n"
+            f"   - Minimum delegate stake balance\n"
+            f"   - Minimum subnet reputation\n\n"
+            f"   You can retry activation once these conditions are met.\n"
+            f"   Add more nodes or delegate stake and try again.",
+            title="⚠️  Activation Conditions Not Met",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    return False  # Error not handled by this function