hippius 0.2.2__py3-none-any.whl → 0.2.3__py3-none-any.whl

hippius_sdk/utils.py

@@ -4,8 +4,21 @@ Utility functions for the Hippius SDK.
 This module provides common utility functions used across the SDK.
 """
 
-import binascii
-from typing import Optional
+import base64
+import sys
+from typing import Any, Optional, Tuple
+
+# Import here to avoid circular imports when these functions are used from utils
+from substrateinterface import SubstrateInterface
+
+# Try importing PyNaCl for encryption functionality
+try:
+    import nacl.secret
+    import nacl.utils
+
+    ENCRYPTION_AVAILABLE = True
+except ImportError:
+    ENCRYPTION_AVAILABLE = False
 
 
 def format_size(size_bytes: int) -> str:
@@ -150,3 +163,72 @@ def format_cid(cid: str) -> str:
         str: Formatted CID string
     """
     return hex_to_ipfs_cid(cid)
+
+
+def generate_key() -> str:
+    """
+    Generate a random encryption key for NaCl secretbox.
+
+    Returns:
+        str: A base64-encoded encryption key that can be used with the SDK's
+             encryption functions or stored in configuration.
+
+    Raises:
+        SystemExit: If PyNaCl is not installed
+    """
+    if not ENCRYPTION_AVAILABLE:
+        print(
+            "Error: PyNaCl is required for encryption. Install it with: pip install pynacl"
+        )
+        sys.exit(1)
+
+    # Generate a random key
+    key = nacl.utils.random(nacl.secret.SecretBox.KEY_SIZE)
+
+    # Encode to base64 for storage and configuration
+    encoded_key = base64.b64encode(key).decode()
+
+    return encoded_key
+
+
+def initialize_substrate_connection(
+    self_obj: Any,
+) -> Tuple[SubstrateInterface, Optional[str]]:
+    """
+    Initialize a Substrate connection if not already connected and set up the account.
+    This function handles initializing the substrate connection and determining the account address
+    to use in blockchain operations.
+
+    Args:
+        self_obj: The object (usually SubstrateClient instance) with required attributes
+
+    Returns:
+        Tuple[SubstrateInterface, Optional[str]]: A tuple containing the Substrate interface
+        object and the account address (or None if no address is available)
+    """
+    # Initialize Substrate connection if not already connected
+    if not hasattr(self_obj, "_substrate") or self_obj._substrate is None:
+        print("Initializing Substrate connection...")
+        self_obj._substrate = SubstrateInterface(
+            url=self_obj.url,
+            ss58_format=42,  # Substrate default
+            type_registry_preset="substrate-node-template",
+        )
+        print(f"Connected to Substrate node at {self_obj.url}")
+
+    # Use provided account address or default to keypair/configured address
+    account_address = None
+    if hasattr(self_obj, "_account_address") and self_obj._account_address:
+        account_address = self_obj._account_address
+
+    elif hasattr(self_obj, "_ensure_keypair") and callable(self_obj._ensure_keypair):
+        # Try to get the address from the keypair (requires seed phrase)
+        if not self_obj._ensure_keypair():
+            # No keypair available, so we'll return None for account_address
+            return self_obj._substrate, None
+
+        if hasattr(self_obj, "_keypair") and self_obj._keypair:
+            account_address = self_obj._keypair.ss58_address
+            print(f"Using keypair address: {account_address}")
+
+    return self_obj._substrate, account_address

hippius-0.2.2.dist-info/RECORD

@@ -1,12 +0,0 @@
-hippius_sdk/__init__.py,sha256=jIwroAMjn-FSQ1lRnW95UhpLbGGronX4i-HEg7bGatA,1391
-hippius_sdk/cli.py,sha256=kPcz1CWh2M4yiajTrYWtc6KZGE_WowLL6WBxY66w7aU,103906
-hippius_sdk/client.py,sha256=mMKX_m2ZwfbGVAU3zasHZQF0ddToqypkxGKTylruB3Y,14901
-hippius_sdk/config.py,sha256=WqocYwx-UomLeZ-iFUNDjg9vRcagOBA1Th68XELbuTs,22950
-hippius_sdk/ipfs.py,sha256=WWSQuBe4Pqsp5WYavpTkMDk7OLgiHGl-CrPnv7LQlzA,56738
-hippius_sdk/ipfs_core.py,sha256=w6ljgFdUzL-ffKxr4x_W-aYZTNpgyJg5HOFDrLKPILA,6690
-hippius_sdk/substrate.py,sha256=9SkjIkMClkyE004H855C4t2VoJr6ypi87r6geBFEFeA,60091
-hippius_sdk/utils.py,sha256=-N0w0RfXhwxJgSkSroxqFMw-0zJQXvcmxM0OS5UtWEY,4145
-hippius-0.2.2.dist-info/METADATA,sha256=l6upZwM5i0zjMqxcuOwikusXMpvp_nIOkd-ImcMpwVA,28032
-hippius-0.2.2.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-hippius-0.2.2.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
-hippius-0.2.2.dist-info/RECORD,,