htcli 1.1.0__py3-none-any.whl

src/htcli/commands/node/display.py

@@ -0,0 +1,749 @@
+"""
+Node display functions for RPC-based operations and extrinsic operations.
+"""
+
+from typing import Any, Optional
+
+from ...ui.colors import amount, info, success
+from ...ui.components import HTCLIPanel, create_node_table
+from ...ui.display import HTCLIConsole
+
+console = HTCLIConsole()
+
+
+def display_all_nodes_rpc(nodes_data: list[Any]):
+    """Display all nodes from RPC response."""
+    if not nodes_data:
+        console.print(info("No nodes found across all subnets"))
+        return
+
+    # Create table for all nodes
+    table = create_node_table(nodes_data)
+    console.print(table)
+
+
+def display_node_info_rpc(node_data: Any, subnet_id: int, node_id: int):
+    """Display specific node information from RPC response."""
+    if not node_data:
+        console.print(info(f"Node {node_id} not found in subnet {subnet_id}"))
+        return
+
+    from ...ui.components import HTCLIPanel
+
+    # Helper functions for formatting
+    def format_balance(balance: int) -> str:
+        """Convert raw balance to TENSOR."""
+        return f"{balance / 1e18:,.4f} TENSOR"
+
+    def format_peer_id(peer_id) -> str:
+        """Format peer ID - show only if not empty."""
+        # Handle None, empty bytes, or empty list
+        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 to decode using the peer_id utility function
+            try:
+                from ...utils.blockchain.peer_id import decode_peer_id
+                decoded = decode_peer_id(peer_id)
+                return decoded if decoded else "[dim]Empty[/dim]"
+            except Exception:
+                # Fallback to UTF-8 decode if decode_peer_id fails
+                try:
+                    decoded = peer_id.decode('utf-8', errors='ignore')
+                    return decoded if decoded else "[dim]Empty[/dim]"
+                except Exception:
+                    return "[dim]Invalid[/dim]"
+        # Handle string peer IDs directly
+        if isinstance(peer_id, str):
+            return peer_id if peer_id else "[dim]Not set[/dim]"
+        # Handle list (shouldn't happen if to_bytes is working, but just in case)
+        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)
+
+    def format_identity(identity: dict) -> str:
+        """Format identity dict - show only non-empty fields."""
+        if not identity:
+            return "[dim]No identity set[/dim]"
+
+        # Filter out empty values
+        non_empty = {k: v for k, v in identity.items() if v and v.strip()}
+
+        if not non_empty:
+            return "[dim]No identity information[/dim]"
+
+        lines = []
+        for key, value in non_empty.items():
+            formatted_key = key.replace('_', ' ').title()
+            lines.append(f"    • {formatted_key}: {value}")
+
+        return "\n".join(lines)
+
+    def format_classification(classification: dict) -> str:
+        """Format classification information."""
+        if not classification:
+            return "[dim]Unknown[/dim]"
+
+        node_class = classification.get('node_class', 'Unknown')
+        start_epoch = classification.get('start_epoch', 'N/A')
+
+        # Color code based on class
+        if node_class == 'Active':
+            return f"[green]✓ Active[/green] (since epoch {start_epoch})"
+        elif node_class == 'Deactivated':
+            return f"[yellow]⚠ Deactivated[/yellow] (since epoch {start_epoch})"
+        elif node_class == 'Included':
+            return f"[cyan]◉ Included[/cyan] (since epoch {start_epoch})"
+        elif node_class == 'Queue':
+            return f"[blue]⋯ Queued[/blue] (since epoch {start_epoch})"
+        else:
+            return f"{node_class} (epoch {start_epoch})"
+
+    def format_reputation(reputation: dict) -> str:
+        """Format reputation information."""
+        if not reputation:
+            return "[dim]No reputation data[/dim]"
+
+        score = reputation.get('score', 0) / 1e12  # Assuming score is scaled
+        lifetime_nodes = reputation.get('lifetime_node_count', 0)
+        total_active = reputation.get('total_active_nodes', 0)
+        increases = reputation.get('total_increases', 0)
+        decreases = reputation.get('total_decreases', 0)
+        avg_attestation = reputation.get('average_attestation', 0)
+
+        return f"""    • Score: {score:,.2f}
+    • Lifetime Nodes: {lifetime_nodes}
+    • Active Nodes: {total_active}
+    • Increases: {increases} | Decreases: {decreases}
+    • Avg Attestation: {avg_attestation}"""
+
+    def format_bytes_field(value) -> str:
+        """Best-effort formatting for optional bytes/opaque fields."""
+        if value is None:
+            return "[dim]Not set[/dim]"
+        if isinstance(value, (bytes, bytearray)):
+            try:
+                decoded = value.decode("utf-8", errors="ignore")
+                return decoded if decoded else f"0x{value.hex()}"
+            except Exception:
+                return f"0x{value.hex()}"
+        return str(value)
+
+    # Format balances
+    stake_balance = format_balance(node_data.stake_balance)
+    delegate_stake = format_balance(node_data.node_delegate_stake_balance)
+
+    # Format classification
+    classification_display = format_classification(node_data.classification)
+
+    # Format identity
+    identity_display = format_identity(node_data.identity)
+
+    # Format reputation (prefer coldkey_reputation if available)
+    raw_reputation = getattr(node_data, "coldkey_reputation", None)
+    if not raw_reputation:
+        raw_reputation = getattr(node_data, "reputation", None)
+    reputation_display = format_reputation(raw_reputation)
+
+    # Build the display - show all relevant fields
+    node_info = f"""[htcli.accent]Basic Information[/htcli.accent]
+[htcli.value]Subnet ID:[/htcli.value] {subnet_id}
+[htcli.value]Node ID:[/htcli.value] {node_id}
+[htcli.value]Status:[/htcli.value] {classification_display}
+
+[htcli.accent]Wallet Addresses[/htcli.accent]
+[htcli.value]Coldkey:[/htcli.value] {node_data.coldkey}
+[htcli.value]Hotkey:[/htcli.value] {node_data.hotkey}
+
+[htcli.accent]Network Configuration[/htcli.accent]
+[htcli.value]Peer ID:[/htcli.value] {format_peer_id(node_data.peer_id)}
+[htcli.value]Bootnode Peer ID:[/htcli.value] {format_peer_id(node_data.bootnode_peer_id)}
+[htcli.value]Client Peer ID:[/htcli.value] {format_peer_id(node_data.client_peer_id)}
+[htcli.value]Is Bootnode:[/htcli.value] {"Yes" if node_data.bootnode else "No"}
+
+[htcli.accent]Economics[/htcli.accent]
+[htcli.value]Node Stake:[/htcli.value] {amount(stake_balance)}
+[htcli.value]Total Delegate Stake:[/htcli.value] {amount(delegate_stake)}
+[htcli.value]Delegate Reward Rate:[/htcli.value] {node_data.delegate_reward_rate}%
+[htcli.value]Penalties:[/htcli.value] {getattr(node_data, 'penalties', 0)}
+[htcli.value]Total Node Delegate Stake Shares:[/htcli.value] {getattr(node_data, 'total_node_delegate_stake_shares', 0)}
+[htcli.value]Last Delegate Reward Rate Update Epoch:[/htcli.value] {getattr(node_data, 'last_delegate_reward_rate_update', 0)}
+
+[htcli.accent]Activity & Scheduling[/htcli.accent]
+[htcli.value]Node Slot Index:[/htcli.value] {getattr(node_data, 'node_slot_index', '[dim]N/A[/dim]')}
+[htcli.value]Consecutive Idle Epochs:[/htcli.value] {getattr(node_data, 'consecutive_idle_epochs', 0)}
+[htcli.value]Consecutive Included Epochs:[/htcli.value] {getattr(node_data, 'consecutive_included_epochs', 0)}
+
+[htcli.accent]Custom Parameters[/htcli.accent]
+[htcli.value]Unique:[/htcli.value] {format_bytes_field(getattr(node_data, 'unique', None))}
+[htcli.value]Non-Unique:[/htcli.value] {format_bytes_field(getattr(node_data, 'non_unique', None))}
+
+[htcli.accent]Identity[/htcli.accent]
+{identity_display}
+
+[htcli.accent]Reputation[/htcli.accent]
+{reputation_display}
+[htcli.value]Subnet Node Reputation:[/htcli.value] {getattr(node_data, 'subnet_node_reputation', 0)}
+"""
+
+    panel = HTCLIPanel(
+        node_info,
+        title=f"🔍 Node {node_id} Details",
+        border_style="htcli.info",
+        highlight=True,
+    )
+    panel.render(console.console)
+
+
+def display_overwatch_commits_rpc(
+    commits_data: list[Any], epoch: int, overwatch_node_id: int
+):
+    """Display overwatch commits from RPC response."""
+    if not commits_data:
+        console.print(
+            info(
+                f"No overwatch commits found for epoch {epoch}, node {overwatch_node_id}"
+            )
+        )
+        return
+
+    from ...ui.components import HTCLIPanel
+
+    # Display overwatch commits
+    commits_info = f"""
+[htcli.accent]Overwatch Commits[/htcli.accent]
+
+[htcli.value]Epoch:[/htcli.value] {epoch}
+[htcli.value]Overwatch Node ID:[/htcli.value] {overwatch_node_id}
+[htcli.value]Total Commits:[/htcli.value] {len(commits_data)}
+
+[htcli.accent]Commits:[/htcli.accent]
+{chr(10).join(f"• Subnet {commit['subnet_id']}: {commit['commit_hash']}" for commit in commits_data)}
+"""
+
+    panel = HTCLIPanel(
+        commits_info,
+        title="🔐 Overwatch Commits",
+        border_style="htcli.info",
+        highlight=True,
+    )
+    panel.render(console.console)
+
+
+def display_overwatch_reveals_rpc(
+    reveals_data: list[Any], epoch: int, overwatch_node_id: int
+):
+    """Display overwatch reveals from RPC response."""
+    if not reveals_data:
+        console.print(
+            info(
+                f"No overwatch reveals found for epoch {epoch}, node {overwatch_node_id}"
+            )
+        )
+        return
+
+    from ...ui.components import HTCLIPanel
+
+    # Display overwatch reveals
+    reveals_info = f"""
+[htcli.accent]Overwatch Reveals[/htcli.accent]
+
+[htcli.value]Epoch:[/htcli.value] {epoch}
+[htcli.value]Overwatch Node ID:[/htcli.value] {overwatch_node_id}
+[htcli.value]Total Reveals:[/htcli.value] {len(reveals_data)}
+
+[htcli.accent]Reveals:[/htcli.accent]
+{chr(10).join(f"• Subnet {reveal['subnet_id']}: Weight {reveal['weight']}" for reveal in reveals_data)}
+"""
+
+    panel = HTCLIPanel(
+        reveals_info,
+        title="🔓 Overwatch Reveals",
+        border_style="htcli.info",
+        highlight=True,
+    )
+    panel.render(console.console)
+
+
+# ============================================================================
+# EXTRINSIC DISPLAY FUNCTIONS - Write Operations
+# ============================================================================
+
+
+def display_node_register_result(response):
+    """Display node registration result."""
+    if hasattr(response, "success") and response.success:
+        stake_balance_tensor = (
+            (response.stake_balance / 1e18)
+            if hasattr(response, "stake_balance") and response.stake_balance
+            else 0
+        )
+
+        # Try to get block number if it's missing but we have block_hash
+        block_number = response.block_number if hasattr(response, "block_number") else None
+        if not block_number and hasattr(response, "block_hash") and response.block_hash:
+            try:
+                from ...dependencies import get_client
+                client = get_client()
+                if client and client.rpc and client.rpc.chain:
+                    block_number = client.rpc.chain.get_block_number(response.block_hash)
+            except Exception:
+                pass
+
+        block_hash = getattr(response, "block_hash", None)
+        content = f"""[htcli.success]✅ Node Registered Successfully![/htcli.success]
+
+[htcli.value]Subnet ID:[/htcli.value] {response.subnet_id if hasattr(response, "subnet_id") else "N/A"}
+[htcli.value]Validator ID:[/htcli.value] {response.validator_id if hasattr(response, "validator_id") else "N/A"}
+[htcli.value]Node ID:[/htcli.value] {response.subnet_node_id if hasattr(response, "subnet_node_id") else "N/A"}
+[htcli.value]Hotkey:[/htcli.value] {response.hotkey if hasattr(response, "hotkey") else "N/A"}
+[htcli.value]Initial Stake:[/htcli.value] {amount(f"{stake_balance_tensor:,.4f} TENSOR")}
+[htcli.value]Transaction Hash:[/htcli.value] {response.transaction_hash or "N/A"}
+[htcli.value]Block Number:[/htcli.value] {block_number or "N/A"}
+"""
+        if block_hash:
+            content += f"[htcli.value]Block Hash:[/htcli.value] {block_hash}\n"
+        content += "\n[htcli.info]💡 Your node is now registered! Subnet may need additional nodes to activate.[/htcli.info]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🚀 Node Registration Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.error if hasattr(response, "error") else "Unknown error"
+
+        if "ColdkeyRegistrationWhitelist" in error_msg:
+            panel = HTCLIPanel(
+                """Only whitelisted coldkeys can register nodes while the subnet is still in its registration period.
+
+💡 What you can do:
+• Use one of the coldkeys supplied in --initial-coldkeys when the subnet was created
+• Check each coldkey's remaining slots via `htcli subnet info --subnet-id <id>`
+• Wait until the subnet activates—once active, the whitelist is removed
+""",
+                title="⚠️ Coldkey Not On Registration Whitelist",
+                border_style="htcli.error",
+                highlight=True,
+            )
+            panel.render(console.console)
+            return
+
+        # Parse error message - it might be a dict or string
+        error_text = str(error_msg)
+        if isinstance(error_msg, dict):
+            # Extract message and data from error dict
+            error_text = error_msg.get("message", "Transaction failed")
+            error_data = error_msg.get("data", "")
+            if error_data:
+                error_text = f"{error_text}: {error_data}"
+
+        # Handle specific error types with helpful messages
+        error_lower = error_text.lower()
+
+        if "maxregisterednodes" in error_lower or "max registered nodes" in error_lower:
+            panel = HTCLIPanel(
+                """The subnet has reached its maximum number of registered nodes.
+
+💡 What this means:
+• Each subnet has a MaxRegisteredNodes limit controlling how many nodes can be registered
+• This limit may also include per-coldkey registration slots from the subnet's initial coldkeys
+
+💡 What you can do:
+• Check current node count and limits: htcli subnet info --subnet-id <id>
+• If you are the subnet owner, increase the max registered nodes via subnet configuration/governance
+• Or remove an existing node first: htcli node remove --subnet-id <id> --node-id <node-id>
+""",
+                title="⚠️ Subnet Node Capacity Reached",
+                border_style="htcli.error",
+                highlight=True,
+            )
+            panel.render(console.console)
+            return
+
+        if "inability to pay" in error_lower or "account balance too low" in error_lower or "insufficient" in error_lower:
+            panel = HTCLIPanel(
+                """Your account balance is too low to complete the transaction.
+
+💡 How to fix this:
+• Check your balance: htcli wallet balance --wallet <wallet-name>
+• Ensure you have enough funds for:
+  - The stake amount you specified
+  - Transaction fees (typically 0.001-0.01 TENSOR)
+• Add more funds to your wallet if needed
+""",
+                title="⚠️ Insufficient Balance",
+                border_style="htcli.error",
+                highlight=True,
+            )
+            panel.render(console.console)
+            return
+
+        if "maxstakereached" in error_lower or "max stake reached" in error_lower:
+            panel = HTCLIPanel(
+                """The stake amount you specified exceeds the subnet's maximum stake limit.
+
+💡 How to fix this:
+• Check the subnet's maximum stake: htcli subnet info --subnet-id <id>
+• Reduce your stake amount to be within the subnet's limits
+• The stake amount must be less than or equal to the subnet's max_stake value
+""",
+                title="⚠️ Maximum Stake Limit Reached",
+                border_style="htcli.error",
+                highlight=True,
+            )
+            panel.render(console.console)
+            return
+
+        if "hotkeyhasowner" in error_lower or "hotkey has owner" in error_lower:
+            panel = HTCLIPanel(
+                """This hotkey is already registered to a node.
+
+💡 What this means:
+• Hotkey needs to be unique across the network, not within that subnet
+• The hotkey you're trying to use is already associated with an existing node somewhere on the network
+
+💡 What you can do:
+• Use a different hotkey wallet for this registration
+• Check existing nodes: htcli node list --subnet-id <id>
+• If you need to use this hotkey, you may need to remove the existing node first
+""",
+                title="⚠️ Hotkey Already Registered",
+                border_style="htcli.error",
+                highlight=True,
+            )
+            panel.render(console.console)
+            return
+
+        if "invalid transaction" in error_lower:
+            panel = HTCLIPanel(
+                f"""{error_text}
+
+💡 What you can do:
+• Verify all parameters are correct
+• Check your wallet balance
+• Ensure the subnet is accepting registrations
+• Review command help: htcli node register --help
+""",
+                title="⚠️ Transaction Failed",
+                border_style="htcli.error",
+                highlight=True,
+            )
+            panel.render(console.console)
+            return
+
+        # Generic error display
+        panel = HTCLIPanel(
+            f"""{error_text}
+
+💡 Troubleshooting:
+• Verify node parameters are valid
+• Check that the subnet exists and accepts registrations
+• Ensure you have sufficient balance for stake and fees
+• Review command help: htcli node register --help
+""",
+            title="⚠️ Node Registration Failed",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        panel.render(console.console)
+
+
+def display_node_bootnode_peer_update(
+    response, subnet_id: int, node_id: int, old_peer_id: Optional[str], new_peer_id: str
+):
+    """Display bootnode peer ID update result."""
+    if hasattr(response, "success") and response.success:
+        old_display = old_peer_id[:50] + "..." if old_peer_id and len(old_peer_id) > 50 else (old_peer_id or "N/A")
+        new_display = new_peer_id[:50] + "..." if len(new_peer_id) > 50 else new_peer_id
+
+        tx_hash = getattr(response, "transaction_hash", None) or getattr(response, "extrinsic_hash", None)
+        block_number = getattr(response, "block_number", None)
+        block_hash = getattr(response, "block_hash", None)
+
+        content = f"""[htcli.success]✅ Bootnode Peer ID Updated Successfully![/htcli.success]
+
+[htcli.value]Subnet ID:[/htcli.value] {subnet_id}
+[htcli.value]Node ID:[/htcli.value] {node_id}
+[htcli.value]Old Bootnode Peer ID:[/htcli.value] {old_display}
+[htcli.value]New Bootnode Peer ID:[/htcli.value] {new_display}
+[htcli.value]Transaction Hash:[/htcli.value] {tx_hash or "N/A"}
+[htcli.value]Block Number:[/htcli.value] {block_number or "N/A"}
+"""
+        if block_hash:
+            content += f"[htcli.value]Block Hash:[/htcli.value] {block_hash}\n"
+        content += "\n[htcli.info]💡 The node's bootnode peer ID has been updated on-chain.[/htcli.info]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🔄 Bootnode Peer ID Update Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.error if hasattr(response, "error") else "Unknown error"
+        console.print(f"[htcli.error]❌ Failed to update bootnode peer ID: {error_msg}[/]")
+
+
+def display_node_client_peer_update(
+    response, subnet_id: int, node_id: int, old_peer_id: Optional[str], new_peer_id: str
+):
+    """Display client peer ID update result."""
+    if hasattr(response, "success") and response.success:
+        old_display = old_peer_id[:50] + "..." if old_peer_id and len(old_peer_id) > 50 else (old_peer_id or "N/A")
+        new_display = new_peer_id[:50] + "..." if len(new_peer_id) > 50 else new_peer_id
+
+        tx_hash = getattr(response, "transaction_hash", None) or getattr(response, "extrinsic_hash", None)
+        block_number = getattr(response, "block_number", None)
+        block_hash = getattr(response, "block_hash", None)
+
+        content = f"""[htcli.success]✅ Client Peer ID Updated Successfully![/htcli.success]
+
+[htcli.value]Subnet ID:[/htcli.value] {subnet_id}
+[htcli.value]Node ID:[/htcli.value] {node_id}
+[htcli.value]Old Client Peer ID:[/htcli.value] {old_display}
+[htcli.value]New Client Peer ID:[/htcli.value] {new_display}
+[htcli.value]Transaction Hash:[/htcli.value] {tx_hash or "N/A"}
+[htcli.value]Block Number:[/htcli.value] {block_number or "N/A"}
+"""
+        if block_hash:
+            content += f"[htcli.value]Block Hash:[/htcli.value] {block_hash}\n"
+        content += "\n[htcli.info]💡 The node's client peer ID has been updated on-chain.[/htcli.info]\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🔄 Client Peer ID Update Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = response.error if hasattr(response, "error") else "Unknown error"
+        console.print(f"[htcli.error]❌ Failed to update client peer ID: {error_msg}[/]")
+
+
+def display_node_remove_result(
+    result: Any,
+    subnet_id: int,
+    node_id: int,
+):
+    """Display subnet node removal result."""
+    success_flag = (
+        result.get("success", False) if isinstance(result, dict) else getattr(result, "success", False)
+    )
+
+    if success_flag:
+        tx_hash = (
+            result.get("transaction_hash")
+            or result.get("extrinsic_hash")
+            if isinstance(result, dict)
+            else getattr(result, "transaction_hash", None)
+            or getattr(result, "extrinsic_hash", None)
+        )
+        block_number = (
+            result.get("block_number") if isinstance(result, dict) else getattr(result, "block_number", None)
+        )
+        block_hash = (
+            result.get("block_hash") if isinstance(result, dict) else getattr(result, "block_hash", None)
+        )
+
+        content = f"""[htcli.success]✅ Node Removed Successfully[/htcli.success]
+
+[htcli.value]Subnet ID:[/htcli.value] {subnet_id}
+[htcli.value]Node ID:[/htcli.value] {node_id}
+[htcli.value]Transaction Hash:[/htcli.value] {tx_hash or "N/A"}
+[htcli.value]Block Number:[/htcli.value] {block_number or "N/A"}
+"""
+        if block_hash:
+            content += f"[htcli.value]Block Hash:[/htcli.value] {block_hash}\n"
+
+        panel = HTCLIPanel(
+            content,
+            title="🗑️ Node Removal Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = result.get("error", "Unknown error") if isinstance(result, dict) else getattr(
+            result, "error", "Unknown error"
+        )
+        console.print(f"[htcli.error]❌ Failed to remove node: {error_msg}[/]")
+
+
+def display_node_lifecycle_result(
+    result: Any,
+    subnet_id: int,
+    node_id: int,
+    action: str,
+):
+    """Display subnet node activation/deactivation result."""
+    success_flag = (
+        result.get("success", False)
+        if isinstance(result, dict)
+        else getattr(result, "success", False)
+    )
+    action_title = action.title()
+
+    if success_flag:
+        tx_hash = (
+            result.get("transaction_hash") or result.get("extrinsic_hash")
+            if isinstance(result, dict)
+            else getattr(result, "transaction_hash", None)
+            or getattr(result, "extrinsic_hash", None)
+        )
+        block_number = (
+            result.get("block_number")
+            if isinstance(result, dict)
+            else getattr(result, "block_number", None)
+        )
+        block_hash = (
+            result.get("block_hash")
+            if isinstance(result, dict)
+            else getattr(result, "block_hash", None)
+        )
+
+        content = f"""[htcli.success]✅ Node {action_title}d Successfully[/htcli.success]
+
+[htcli.value]Subnet ID:[/htcli.value] {subnet_id}
+[htcli.value]Node ID:[/htcli.value] {node_id}
+[htcli.value]Transaction Hash:[/htcli.value] {tx_hash or "N/A"}
+[htcli.value]Block Number:[/htcli.value] {block_number or "N/A"}
+"""
+        if block_hash:
+            content += f"[htcli.value]Block Hash:[/htcli.value] {block_hash}\n"
+
+        panel = HTCLIPanel(
+            content,
+            title=f"Node {action_title} Complete",
+            border_style="htcli.success",
+            highlight=True,
+        )
+        panel.render(console.console)
+    else:
+        error_msg = (
+            result.get("error", "Unknown error")
+            if isinstance(result, dict)
+            else getattr(result, "error", "Unknown error")
+        )
+        console.print(f"[htcli.error]❌ Failed to {action} node: {error_msg}[/]")
+
+
+def display_node_update_summary(
+    subnet_id: int,
+    node_id: int,
+    updates: list[dict[str, Any]],
+    client: Optional[Any] = None,
+):
+    """
+    Display a consolidated summary of multiple node updates in a single panel.
+
+    Each entry in `updates` should be a dict with:
+      - field: str
+      - old: Any
+      - new: Any
+      - result: dict or response object
+    """
+    if not updates:
+        return
+
+    def format_field_name(field: str) -> str:
+        return field.replace("_", " ").title()
+
+    def get_transaction_hash(result: Any) -> Optional[str]:
+        if isinstance(result, dict):
+            return result.get("transaction_hash") or result.get("extrinsic_hash")
+        return (
+            getattr(result, "transaction_hash", None)
+            or getattr(result, "extrinsic_hash", None)
+        )
+
+    def get_block_hash(result: Any) -> Optional[str]:
+        if isinstance(result, dict):
+            return result.get("block_hash")
+        return getattr(result, "block_hash", None)
+
+    def get_block_number(result: Any) -> Optional[int]:
+        if isinstance(result, dict):
+            return result.get("block_number")
+        return getattr(result, "block_number", None)
+
+    def is_success(result: Any) -> bool:
+        if isinstance(result, dict):
+            return bool(result.get("success", False))
+        return bool(getattr(result, "success", False))
+
+    lines: list[str] = [
+        success(
+            f"✅ Node {node_id} on subnet {subnet_id} updated successfully!"
+        )
+    ]
+    lines.append("")  # blank line
+
+    for update in updates:
+        field = update.get("field")
+        old = update.get("old")
+        new = update.get("new")
+        result = update.get("result")
+
+        field_display = format_field_name(str(field))
+        status_text = "[green]Success[/green]" if is_success(result) else "[htcli.error]Failed[/htcli.error]"
+        lines.append(f"[htcli.value]{field_display}:[/] {status_text}")
+
+        if old is not None or new is not None:
+            old_disp = str(old) if old is not None else "[dim]N/A[/dim]"
+            new_disp = str(new) if new is not None else "[dim]N/A[/dim]"
+            lines.append(f"  [htcli.subtitle]Old:[/] {old_disp}")
+            lines.append(f"  [htcli.subtitle]New:[/] {new_disp}")
+
+        tx_hash = get_transaction_hash(result)
+        block_hash = get_block_hash(result)
+        block_number = get_block_number(result)
+
+        if not block_number and block_hash and client and getattr(client, "rpc", None) and getattr(
+            client.rpc, "chain", None
+        ):
+            try:
+                block_number = client.rpc.chain.get_block_number(block_hash=block_hash)
+            except Exception:
+                pass
+
+        if tx_hash:
+            lines.append(
+                f"  [htcli.subtitle]Transaction Hash:[/] [htcli.hash]{tx_hash}[/]"
+            )
+        if block_number:
+            lines.append(
+                f"  [htcli.subtitle]Block Number:[/] [htcli.value]{block_number}[/]"
+            )
+        if block_hash:
+            lines.append(
+                f"  [htcli.subtitle]Block Hash:[/] [htcli.hash]{block_hash}[/]"
+            )
+            lines.append(
+            )
+
+        lines.append("")  # space between updates
+
+    if lines and lines[-1] == "":
+        lines.pop()
+
+    content = "\n".join(lines)
+
+    panel = HTCLIPanel(
+        content,
+        title="✅ Node Updates Complete",
+        border_style="htcli.success",
+        highlight=True,
+    )
+    panel.render(console.console)