htcli 1.1.0__py3-none-any.whl

src/htcli/commands/overwatch/display.py

@@ -0,0 +1,396 @@
+"""
+Overwatch display functions for RPC-based operations and extrinsic operations.
+"""
+
+from typing import Any, List, Optional
+
+from ...ui.colors import amount, info, success
+from ...ui.components import HTCLIPanel, HTCLITable
+from ...ui.display import HTCLIConsole
+
+console = HTCLIConsole()
+
+
+def format_balance(balance: int) -> str:
+    """Convert raw balance (wei) to TENSOR."""
+    return f"{balance / 1e18:,.4f}"
+
+
+def format_peer_id(peer_id) -> str:
+    """Format peer ID - show only if not empty."""
+    if not peer_id:
+        return "[dim]Not set[/dim]"
+    if isinstance(peer_id, bytes):
+        if len(peer_id) == 0:
+            return "[dim]Not set[/dim]"
+        try:
+            decoded = peer_id.decode('utf-8', errors='ignore')
+            return decoded if decoded else "[dim]Empty[/dim]"
+        except Exception:
+            return "[dim]Invalid[/dim]"
+    if isinstance(peer_id, str):
+        return peer_id if peer_id else "[dim]Not set[/dim]"
+    if isinstance(peer_id, list):
+        if len(peer_id) == 0:
+            return "[dim]Not set[/dim]"
+        try:
+            return format_peer_id(bytes(peer_id))
+        except Exception:
+            return "[dim]Invalid[/dim]"
+    return str(peer_id)
+
+
+# ============================================================================
+# RPC DISPLAY FUNCTIONS - Read Operations
+# ============================================================================
+
+
+def display_overwatch_qualification(data: dict):
+    """Display overwatch qualification check results.
+    
+    Shows a detailed breakdown of requirements met and failed,
+    similar to subnet check-activation display.
+    """
+    can_register = data.get("can_register", False)
+    requirements_met = data.get("requirements_met", [])
+    requirements_failed = data.get("requirements_failed", [])
+    details = data.get("details", {})
+    coldkey = data.get("coldkey", "Unknown")
+    
+    # Truncate coldkey for display
+    # Use centralized formatter for consistency
+    from ...utils.wallet.crypto import format_address_display
+    coldkey_display = format_address_display(coldkey)
+    
+    # Build content
+    if can_register:
+        status_line = "[htcli.success]✅ QUALIFIED - Can register as overwatch node[/htcli.success]"
+        border_style = "htcli.success"
+        title_emoji = "✅"
+    else:
+        status_line = "[htcli.error]❌ NOT QUALIFIED - Cannot register as overwatch node yet[/htcli.error]"
+        border_style = "htcli.error"
+        title_emoji = "❌"
+    
+    content = f"""{status_line}
+
+[htcli.accent]Coldkey:[/htcli.accent] [htcli.address]{coldkey_display}[/htcli.address]
+
+"""
+    
+    # Requirements Met section
+    if requirements_met:
+        content += "[htcli.success]✅ Requirements Met:[/htcli.success]\n"
+        for req in requirements_met:
+            content += f"   [htcli.success]•[/htcli.success] {req}\n"
+        content += "\n"
+    
+    # Requirements Failed section
+    if requirements_failed:
+        content += "[htcli.error]❌ Requirements Not Met:[/htcli.error]\n"
+        for req in requirements_failed:
+            content += f"   [htcli.error]•[/htcli.error] {req}\n"
+        content += "\n"
+    
+    # Show network status details
+    content += "[htcli.accent]Network Status:[/htcli.accent]\n"
+    content += f"   • Overwatch Epoch: {details.get('current_overwatch_epoch', 'N/A')}\n"
+    content += f"   • Current Epoch: {details.get('current_epoch', 'N/A')}\n"
+    content += f"   • Overwatch Nodes: {details.get('total_overwatch_nodes', 'N/A')}/{details.get('max_overwatch_nodes', 'N/A')}\n"
+    content += f"   • Active Subnets: {details.get('total_active_subnets', 'N/A')}\n"
+    content += "\n"
+    
+    # Show your status
+    content += "[htcli.accent]Your Status:[/htcli.accent]\n"
+    content += f"   • Subnets with Nodes: {details.get('coldkey_subnets', 0)}\n"
+    content += f"   • Balance: {details.get('balance_tensor', 0):,.2f}\n"
+    
+    # Tips if not qualified
+    if not can_register:
+        content += "\n[htcli.warning]💡 Tips to Qualify:[/htcli.warning]\n"
+        content += "   • Run nodes on multiple subnets to increase diversification\n"
+        content += "   • Maintain high attestation rate to build reputation\n"
+        content += f"   • Need at least {details.get('min_stake_tensor', 0):,.2f} for initial stake\n"
+    
+    panel = HTCLIPanel(
+        content,
+        title=f"{title_emoji} Overwatch Qualification Check",
+        border_style=border_style,
+        highlight=True,
+    )
+    panel.render(console.console)
+
+
+def display_overwatch_list(nodes_data: List[Any]):
+    """Display all overwatch nodes from RPC response."""
+    if not nodes_data:
+        console.print(info("No overwatch nodes found on the network"))
+        return
+
+    # Create table for overwatch nodes
+    table = HTCLITable(title="Overwatch Nodes")
+    table.add_column("ID", style="htcli.accent", justify="right")
+    table.add_column("Coldkey", style="htcli.address")
+    table.add_column("Hotkey", style="htcli.address")
+    table.add_column("Stake", style="htcli.value", justify="right")
+    table.add_column("Penalties", style="htcli.value", justify="right")
+
+    for node in nodes_data:
+        node_id = getattr(node, "overwatch_node_id", "N/A")
+        coldkey = getattr(node, "coldkey", "N/A")
+        hotkey = getattr(node, "hotkey", "N/A")
+        penalties = getattr(node, "penalties", 0)
+        stake_balance = getattr(node, "stake_balance", 0)
+        stake_tensor = stake_balance / 1e18 if stake_balance else 0
+
+        # Truncate addresses for display: 0x<5 chars>...<5 chars>
+        from ...utils.wallet.crypto import format_address_display
+        coldkey_display = format_address_display(str(coldkey))
+        hotkey_display = format_address_display(str(hotkey))
+
+        table.add_row(
+            str(node_id),
+            coldkey_display,
+            hotkey_display,
+            f"{stake_tensor:,.2f}",
+            str(penalties),
+        )
+
+    table.render()
+    console.print(f"\n[htcli.info]Total: {len(nodes_data)} overwatch node(s)[/]")
+
+
+
+def display_overwatch_node_info(node_data: Any):
+    """Display specific overwatch node information from RPC response."""
+    from ...utils.wallet.crypto import format_address_display
+    
+    if not node_data:
+        console.print(info("Overwatch node not found"))
+        return
+
+    node_id = getattr(node_data, "overwatch_node_id", "N/A")
+    coldkey = getattr(node_data, "coldkey", "N/A")
+    hotkey = getattr(node_data, "hotkey", "N/A")
+    penalties = getattr(node_data, "penalties", 0)
+    peer_ids = getattr(node_data, "peer_ids", [])
+    reputation = getattr(node_data, "reputation", None)
+    stake_balance = getattr(node_data, "stake_balance", 0)
+
+    # Format stake balance
+    stake_tensor = stake_balance / 1e18 if stake_balance else 0
+
+    # Format peer IDs
+    peer_ids_display = "None"
+    if peer_ids:
+        formatted_peers = []
+        # Sort by subnet ID for consistent display
+        sorted_peers = sorted(peer_ids.items())
+        
+        for subnet_id, peer_id in sorted_peers[:5]:  # Limit to first 5
+            formatted_peers.append(f"  • Subnet {subnet_id}: {format_peer_id(peer_id)}")
+        peer_ids_display = "\n".join(formatted_peers)
+        if len(peer_ids) > 5:
+            peer_ids_display += f"\n  ... and {len(peer_ids) - 5} more"
+
+    # Format reputation
+    reputation_display = "[dim]No reputation data[/dim]"
+    if reputation:
+        rep_score = reputation.get('score', 0) / 1e12
+        reputation_display = f"""    • Score: {rep_score:,.2f}
+    • Lifetime Nodes: {reputation.get('lifetime_node_count', 0)}
+    • Active Nodes: {reputation.get('total_active_nodes', 0)}
+    • Avg Attestation: {reputation.get('average_attestation', 0)}"""
+
+    content = f"""[htcli.accent]Basic Information[/htcli.accent]
+[htcli.value]Overwatch Node ID:[/htcli.value] {node_id}
+[htcli.value]Penalties:[/htcli.value] {penalties}
+
+[htcli.accent]Stake[/htcli.accent]
+[htcli.value]Current Stake:[/htcli.value] {stake_tensor:,.4f}
+
+[htcli.accent]Wallet Addresses[/htcli.accent]
+[htcli.value]Coldkey:[/htcli.value] [htcli.address]{format_address_display(str(coldkey), truncate=False)}[/htcli.address]
+[htcli.value]Hotkey:[/htcli.value] [htcli.address]{format_address_display(str(hotkey), truncate=False)}[/htcli.address]
+
+[htcli.accent]Peer IDs by Subnet[/htcli.accent]
+{peer_ids_display}
+
+[htcli.accent]Reputation[/htcli.accent]
+{reputation_display}
+"""
+
+    panel = HTCLIPanel(
+        content,
+        title=f"🔮 Overwatch Node {node_id} Details",
+        border_style="htcli.info",
+        highlight=True,
+    )
+    panel.render(console.console)
+
+
+# ============================================================================
+# EXTRINSIC DISPLAY FUNCTIONS - Write Operations
+# ============================================================================
+
+
+def display_overwatch_register_result(response: dict):
+    """Display overwatch node registration result."""
+    from ...utils.wallet.crypto import format_address_display
+    
+    if response.get("success"):
+        stake_wei = response.get("stake_added", 0)
+        stake_tensor = stake_wei / 1e18 if stake_wei else 0
+        hotkey = format_address_display(response.get("hotkey", "N/A"), truncate=False)
+
+        content = f"""[htcli.success]✅ Overwatch Node Registered Successfully![/htcli.success]
+
+[htcli.value]Overwatch Node ID:[/htcli.value] {response.get("overwatch_node_id", "Pending")}
+[htcli.value]Hotkey:[/htcli.value] [htcli.address]{hotkey}[/htcli.address]
+[htcli.value]Initial Stake:[/htcli.value] {stake_tensor:,.4f}
+[htcli.value]Transaction Hash:[/htcli.value] {response.get("transaction_hash", "N/A")}
+[htcli.value]Block Number:[/htcli.value] {response.get("block_number", "N/A")}
+"""
+        if response.get("block_hash"):
+            content += f"[htcli.value]Block Hash:[/htcli.value] {response.get('block_hash')}\n"
+        content += "\n[htcli.info]💡 Your overwatch node is now registered! You can start participating in consensus.[/htcli.info]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🔮 Overwatch Node Registration Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.get("error", "Unknown error")
+        panel = HTCLIPanel(
+            f"""{error_msg}
+
+💡 Troubleshooting:
+• Ensure you meet the reputation requirements for overwatch nodes
+• Verify you have sufficient balance for stake and fees
+• Check that your hotkey is not already registered
+• Review: htcli overwatch register --help
+""",
+            title="⚠️ Overwatch Node Registration Failed",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        panel.render(console.console)
+
+
+def display_overwatch_remove_result(response: dict):
+    """Display overwatch node removal result."""
+    if response.get("success"):
+        content = f"""[htcli.success]✅ Overwatch Node Removed Successfully[/htcli.success]
+
+[htcli.value]Overwatch Node ID:[/htcli.value] {response.get("overwatch_node_id", "N/A")}
+[htcli.value]Transaction Hash:[/htcli.value] {response.get("transaction_hash", "N/A")}
+[htcli.value]Block Number:[/htcli.value] {response.get("block_number", "N/A")}
+"""
+        if response.get("block_hash"):
+            content += f"[htcli.value]Block Hash:[/htcli.value] {response.get('block_hash')}\n"
+        content += "\n[htcli.info]💡 Your overwatch node has been removed. Any staked balance will enter unbonding.[/htcli.info]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🗑️ Overwatch Node Removal Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.get("error", "Unknown error")
+        console.print(f"[htcli.error]❌ Failed to remove overwatch node: {error_msg}[/]")
+
+
+def display_overwatch_peer_id_result(response: dict):
+    """Display set peer ID result."""
+    if response.get("success"):
+        content = f"""[htcli.success]✅ Peer ID Set Successfully[/htcli.success]
+
+[htcli.value]Subnet ID:[/htcli.value] {response.get("subnet_id", "N/A")}
+[htcli.value]Overwatch Node ID:[/htcli.value] {response.get("overwatch_node_id", "N/A")}
+[htcli.value]Peer ID:[/htcli.value] {response.get("peer_id", "N/A")}
+[htcli.value]Transaction Hash:[/htcli.value] {response.get("transaction_hash", "N/A")}
+[htcli.value]Block Number:[/htcli.value] {response.get("block_number", "N/A")}
+"""
+        if response.get("block_hash"):
+            content += f"[htcli.value]Block Hash:[/htcli.value] {response.get('block_hash')}\n"
+        content += "\n[htcli.info]💡 Your peer ID has been registered for this subnet.[/htcli.info]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🔗 Peer ID Update Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.get("error", "Unknown error")
+        console.print(f"[htcli.error]❌ Failed to set peer ID: {error_msg}[/]")
+
+
+def display_overwatch_stake_add_result(response: dict):
+    """Display add stake result."""
+    from ...utils.wallet.crypto import format_address_display
+    
+    if response.get("success"):
+        stake_wei = response.get("stake_added", 0)
+        stake_tensor = stake_wei / 1e18 if stake_wei else 0
+        hotkey = format_address_display(response.get("hotkey", "N/A"), truncate=False)
+
+        content = f"""[htcli.success]✅ Stake Added Successfully[/htcli.success]
+
+[htcli.value]Overwatch Node ID:[/htcli.value] {response.get("overwatch_node_id", "N/A")}
+[htcli.value]Hotkey:[/htcli.value] [htcli.address]{hotkey}[/htcli.address]
+[htcli.value]Stake Added:[/htcli.value] {stake_tensor:,.4f}
+[htcli.value]Transaction Hash:[/htcli.value] {response.get("transaction_hash", "N/A")}
+[htcli.value]Block Number:[/htcli.value] {response.get("block_number", "N/A")}
+"""
+        if response.get("block_hash"):
+            content += f"[htcli.value]Block Hash:[/htcli.value] {response.get('block_hash')}\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="💰 Overwatch Stake Added",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.get("error", "Unknown error")
+        console.print(f"[htcli.error]❌ Failed to add stake: {error_msg}[/]")
+
+
+def display_overwatch_stake_remove_result(response: dict):
+    """Display remove stake result."""
+    from ...utils.wallet.crypto import format_address_display
+    
+    if response.get("success"):
+        stake_wei = response.get("stake_removed", 0)
+        stake_tensor = stake_wei / 1e18 if stake_wei else 0
+        hotkey = format_address_display(response.get("hotkey", "N/A"), truncate=False)
+
+        content = f"""[htcli.success]✅ Stake Removal Started[/htcli.success]
+
+[htcli.value]Hotkey:[/htcli.value] [htcli.address]{hotkey}[/htcli.address]
+[htcli.value]Stake Removed:[/htcli.value] {stake_tensor:,.4f}
+[htcli.value]Transaction Hash:[/htcli.value] {response.get("transaction_hash", "N/A")}
+[htcli.value]Block Number:[/htcli.value] {response.get("block_number", "N/A")}
+"""
+        if response.get("block_hash"):
+            content += f"[htcli.value]Block Hash:[/htcli.value] {response.get('block_hash')}\n"
+        content += "\n[htcli.warning]⚠️ Removed stake will be available after the unbonding period.[/htcli.warning]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="💸 Overwatch Stake Removal Initiated",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.get("error", "Unknown error")
+        console.print(f"[htcli.error]❌ Failed to remove stake: {error_msg}[/]")

src/htcli/commands/overwatch/error_handling.py

@@ -0,0 +1,276 @@
+"""
+Error handling utilities for overwatch commands.
+Provides user-friendly error messages for all overwatch-related errors.
+"""
+
+from typing import Optional
+
+from ...ui.components import HTCLIPanel
+from ...ui.display import HTCLIConsole
+
+
+def handle_overwatch_error(
+    error_msg: str,
+    overwatch_node_id: Optional[int] = None,
+    operation: str = "operation",
+    client=None,
+) -> bool:
+    """
+    Handle overwatch-related errors with user-friendly messages.
+
+    Args:
+        error_msg: The error message from the blockchain
+        overwatch_node_id: The overwatch node 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()
+    node_id_str = f" {overwatch_node_id}" if overwatch_node_id is not None else ""
+    
+    # Normalize error message for case-insensitive matching
+    error_msg_lower = error_msg.lower()
+
+    # =========================================================================
+    # Registration Errors
+    # =========================================================================
+    
+    if "coldkeyblacklisted" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Your coldkey is blacklisted from registering overwatch nodes.\n\n"
+            f"💡 Blacklisted accounts cannot participate as overwatch nodes.\n"
+            f"   Contact support if you believe this is in error.",
+            title="🚫 Coldkey Blacklisted",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "overwatchepochiszero" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Overwatch epoch has not started yet.\n\n"
+            f"💡 The overwatch system is not yet active on the network.\n"
+            f"   Wait for the first overwatch epoch to begin before registering.",
+            title="⏳ Overwatch Not Started",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "maxoverwatchnodes" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Maximum number of overwatch nodes has been reached.\n\n"
+            f"💡 The network has a cap on the number of overwatch nodes.\n"
+            f"   Wait for a slot to become available when another node exits.",
+            title="❌ Max Overwatch Nodes Reached",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "coldkeymatcheshotkey" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Coldkey and hotkey cannot be the same account.\n\n"
+            f"💡 You must use different accounts for coldkey and hotkey.\n"
+            f"   Generate a separate hotkey: htcli wallet generate-hotkey",
+            title="❌ Invalid Key Configuration",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "hotkeyhasowner" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"This hotkey is already registered to another account.\n\n"
+            f"💡 Each hotkey can only be owned by one coldkey.\n"
+            f"   Use a fresh hotkey: htcli wallet generate-hotkey",
+            title="❌ Hotkey Already Owned",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "hotkeyalreadyregisteredtocoldkey" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"This hotkey is already registered to your coldkey.\n\n"
+            f"💡 You've already registered this hotkey.\n"
+            f"   Check your existing nodes: htcli overwatch list",
+            title="❌ Hotkey Already Registered",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "coldkeynotoverwatchqualified" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Your coldkey is not qualified to run an overwatch node.\n\n"
+            f"💡 Overwatch nodes require sufficient reputation.\n"
+            f"   Build reputation by running subnet nodes successfully.\n"
+            f"   Check your reputation status: htcli wallet info",
+            title="❌ Not Qualified",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # =========================================================================
+    # Node Existence Errors
+    # =========================================================================
+    
+    elif "invalidoverwatchnodeid" in error_msg_lower or "overwatchnodenotexist" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Overwatch node{node_id_str} does not exist.\n\n"
+            f"💡 Check the overwatch node ID and try again.\n"
+            f"   Use: htcli overwatch list to see all overwatch nodes",
+            title="❌ Invalid Overwatch Node",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "notoverwatchnodeowner" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"You are not the owner of overwatch node{node_id_str}.\n\n"
+            f"💡 Only the coldkey owner can manage this overwatch node.\n"
+            f"   Check your wallet: htcli wallet list",
+            title="❌ Permission Denied",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # =========================================================================
+    # Stake Errors
+    # =========================================================================
+    
+    elif "overwatchminstakenotreached" in error_msg_lower or "minoverwatchstake" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Stake amount is below the minimum requirement for overwatch nodes.\n\n"
+            f"💡 Overwatch nodes require a minimum stake to participate.\n"
+            f"   Increase your stake amount and try again.",
+            title="❌ Below Minimum Stake",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "notenoughoverwatchstake" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Insufficient overwatch stake to remove.\n\n"
+            f"💡 You don't have enough staked balance to remove this amount.\n"
+            f"   Check your current stake: htcli overwatch info",
+            title="❌ Insufficient Stake",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "notenoughbalancetostake" in error_msg_lower or "insufficientbalance" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Insufficient balance to add stake.\n\n"
+            f"💡 You don't have enough balance in your wallet.\n"
+            f"   Check your balance: htcli wallet balance",
+            title="❌ Insufficient Balance",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # =========================================================================
+    # Peer ID Errors
+    # =========================================================================
+    
+    elif "invalidpeerid" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Invalid peer ID format.\n\n"
+            f"💡 The peer ID must be a valid libp2p peer identifier.\n"
+            f"   Example: 12D3KooWxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            title="❌ Invalid Peer ID",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "peeridalreadyinuse" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"This peer ID is already in use by another node.\n\n"
+            f"💡 Each node must have a unique peer ID.\n"
+            f"   Generate a new peer ID for your node.",
+            title="❌ Peer ID Already Used",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # =========================================================================
+    # Removal Errors
+    # =========================================================================
+    
+    elif "overwatchnodecannotberemoved" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Overwatch node{node_id_str} cannot be removed at this time.\n\n"
+            f"💡 The node may be in an active validation epoch.\n"
+            f"   Wait for the current epoch to complete before removing.",
+            title="⚠️  Cannot Remove Node",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "overwatchnodealreadyremoved" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Overwatch node{node_id_str} has already been removed.\n\n"
+            f"💡 This node no longer exists in the network.",
+            title="⚠️  Node Already Removed",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # =========================================================================
+    # System Errors
+    # =========================================================================
+    
+    elif "txratelimitexceeded" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Transaction rate limit exceeded.\n\n"
+            f"⏱️  You've exceeded the maximum transaction rate.\n\n"
+            f"💡 Wait a moment before submitting another transaction.",
+            title="⏳ Rate Limit Exceeded",
+            border_style="htcli.warning",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "badorigin" in error_msg_lower:
+        error_panel = HTCLIPanel(
+            f"Invalid transaction signature.\n\n"
+            f"💡 Make sure you're using the correct wallet.\n"
+            f"   Check your wallet: htcli wallet list",
+            title="❌ Invalid Signature",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    return False  # Error not handled by this function