htcli 1.1.0__py3-none-any.whl

src/htcli/commands/wallet/error_handling.py

@@ -0,0 +1,210 @@
+"""
+Error handling utilities for wallet extrinsics commands.
+Provides user-friendly error messages for all wallet-related blockchain errors.
+"""
+
+from typing import Optional
+
+from ...ui.components import HTCLIPanel
+from ...ui.display import HTCLIConsole
+
+
+def handle_wallet_extrinsic_error(
+    error_msg: str,
+    operation: str = "operation",
+    client=None,
+) -> bool:
+    """
+    Handle wallet extrinsic-related errors with user-friendly messages.
+
+    Args:
+        error_msg: The error message from the blockchain
+        operation: Description of the operation being performed (e.g., "transfer", "update coldkey")
+        client: Optional client instance for fetching additional info
+
+    Returns:
+        bool: True if error was handled, False otherwise
+    """
+    console = HTCLIConsole()
+
+    # 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
+
+    # Transfer-specific errors
+    elif "InsufficientBalance" in error_msg or "NotEnoughBalance" in error_msg or "insufficient balance" in error_msg.lower():
+        error_panel = HTCLIPanel(
+            f"Insufficient balance to complete the transfer.\n\n"
+            f"💡 You don't have enough balance in your wallet to complete this transaction.\n"
+            f"   Accounts must maintain a minimum balance to stay alive.\n\n"
+            f"   Check your balance: htcli wallet balance\n"
+            f"   Reduce the transfer amount and try again.",
+            title="❌ Insufficient Balance",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "BalanceTooLow" in error_msg or "would kill account" in error_msg.lower() or "BalanceWithdrawalError" in error_msg:
+        error_panel = HTCLIPanel(
+            f"Cannot transfer - would kill account.\n\n"
+            f"💡 Transferring this amount would leave your account with insufficient balance.\n"
+            f"   Accounts must maintain a minimum balance to stay alive.\n\n"
+            f"   Reduce the transfer amount and try again.\n"
+            f"   Check your balance: htcli wallet balance",
+            title="❌ Balance Too Low",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "InvalidAmount" in error_msg or "AmountZero" in error_msg or "amount must be greater than zero" in error_msg.lower():
+        error_panel = HTCLIPanel(
+            f"Invalid transfer amount.\n\n"
+            f"💡 Transfer amount must be greater than zero.\n"
+            f"   Provide a valid amount and try again.",
+            title="❌ Invalid Amount",
+            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 amount to balance 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
+
+    # Update coldkey-specific errors
+    elif "NotKeyOwner" in error_msg or "not the owner" in error_msg.lower():
+        if "update" in operation.lower() or "coldkey" in operation.lower():
+            error_panel = HTCLIPanel(
+                f"You are not the owner of this hotkey.\n\n"
+                f"💡 Only the current coldkey owner can update the hotkey's owner.\n"
+                f"   Make sure you're using the correct coldkey wallet.\n\n"
+                f"   Check your wallet: htcli wallet list\n"
+                f"   Verify hotkey ownership: htcli wallet describe",
+                title="❌ Permission Denied",
+                border_style="htcli.error",
+                highlight=True,
+            )
+        else:
+            error_panel = HTCLIPanel(
+                f"You are not authorized to perform this operation.\n\n"
+                f"💡 Make sure you're using the correct wallet.\n"
+                f"   Check your wallet: htcli wallet list",
+                title="❌ Permission Denied",
+                border_style="htcli.error",
+                highlight=True,
+            )
+        error_panel.render(console.console)
+        return True
+
+    elif "ColdkeyMatchesHotkey" in error_msg or "coldkey matches hotkey" in error_msg.lower():
+        error_panel = HTCLIPanel(
+            f"Cannot set coldkey to match hotkey.\n\n"
+            f"💡 The coldkey and hotkey must be different accounts.\n"
+            f"   This is a security requirement to prevent key confusion.\n\n"
+            f"   Use a different coldkey address and try again.",
+            title="❌ Invalid Key Configuration",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Address validation errors
+    elif "InvalidAddress" in error_msg or "invalid address" in error_msg.lower():
+        error_panel = HTCLIPanel(
+            f"Invalid wallet address.\n\n"
+            f"💡 The provided address is not valid.\n"
+            f"   Check the address format and try again.\n\n"
+            f"   Use: htcli wallet list to see valid wallet addresses",
+            title="❌ Invalid Address",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    # Transaction errors
+    elif "TransactionFailed" in error_msg or "transaction failed" in error_msg.lower():
+        error_panel = HTCLIPanel(
+            f"Transaction failed on the blockchain.\n\n"
+            f"💡 The transaction was submitted but failed during execution.\n"
+            f"   This could be due to:\n"
+            f"   - Insufficient balance\n"
+            f"   - Invalid parameters\n"
+            f"   - Network conditions\n\n"
+            f"   Check your balance and parameters, then try again.",
+            title="❌ Transaction Failed",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    elif "ExhaustedResources" in error_msg or "out of resources" in error_msg.lower():
+        error_panel = HTCLIPanel(
+            f"Transaction exceeds block weight limit.\n\n"
+            f"💡 The transaction is too complex or large for the current block.\n"
+            f"   Try breaking it into smaller transactions or wait for network conditions to improve.",
+            title="❌ Resource Limit Exceeded",
+            border_style="htcli.error",
+            highlight=True,
+        )
+        error_panel.render(console.console)
+        return True
+
+    return False  # Error not handled by this function
+
+