hippius 0.2.10__py3-none-any.whl → 0.2.12__py3-none-any.whl

{hippius-0.2.10.dist-info → hippius-0.2.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hippius
-Version: 0.2.10
+Version: 0.2.12
 Summary: Python SDK and CLI for Hippius blockchain storage
 Home-page: https://github.com/thenervelab/hippius-sdk
 Author: Dubs

hippius-0.2.12.dist-info/RECORD

@@ -0,0 +1,17 @@
+hippius_sdk/__init__.py,sha256=ZcHAg1Tk-gXHUc-AnplM-bD01IvypNFw-gIQzaanRUg,1392
+hippius_sdk/cli.py,sha256=pzwoa-X5cwdA_pM-fqUyXZKHgcZODrLe4qHZuCqQMtQ,18210
+hippius_sdk/cli_assets.py,sha256=V3MX63QTiex6mCp0VDXQJ7cagm5v1s4xtsu8c1O4G_k,371
+hippius_sdk/cli_handlers.py,sha256=DoIyy1x8DnsXD6vjBsS_20UF_nNUGKnLHMk6HoDwdYU,129087
+hippius_sdk/cli_parser.py,sha256=Qh2wgkFBUTPldvGoTQuoNKQl5Vo0x6fPEsPBU5oymP4,20242
+hippius_sdk/cli_rich.py,sha256=_jTBYMdHi2--fIVwoeNi-EtkdOb6Zy_O2TUiGvU3O7s,7324
+hippius_sdk/client.py,sha256=ASMFYd5qH_j-rnC-3Y0FEdlB2xPPvfs9p3SlMUXxGek,19086
+hippius_sdk/config.py,sha256=wVzhVIBtijatVG7MZ3HvAwdsz_-arkTvBf5NUiQHNTo,21841
+hippius_sdk/errors.py,sha256=LScJJmawVAx7aRzqqQguYSkf9iazSjEQEBNlD_GXZ6Y,1589
+hippius_sdk/ipfs.py,sha256=r9GWQNp-6IOaVAZvXEtAupa_rru2u_sb8TtXFN5tkc4,74173
+hippius_sdk/ipfs_core.py,sha256=Wv_nOI2k3YPUVTpOWS98X-955iuMKqH0Fc-t8ZuNLSE,12842
+hippius_sdk/substrate.py,sha256=lp-GF2qfZgD_XwZwc2UNNkp-AkGUpOiZQ5aJUiea8VA,49608
+hippius_sdk/utils.py,sha256=rJ611yvwKSyiBpYU3w-SuyQxoghMGU-ePuslrPv5H5g,7388
+hippius-0.2.12.dist-info/METADATA,sha256=ZEozvditfm-2TXZT0Wt1qserLr6AdcblagGgVZXjA1o,29993
+hippius-0.2.12.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+hippius-0.2.12.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
+hippius-0.2.12.dist-info/RECORD,,

hippius_sdk/__init__.py

@@ -26,7 +26,7 @@ from hippius_sdk.config import (
 from hippius_sdk.ipfs import IPFSClient
 from hippius_sdk.utils import format_cid, format_size, hex_to_ipfs_cid
 
-__version__ = "0.2.10"
+__version__ = "0.2.12"
 __all__ = [
     "HippiusClient",
     "IPFSClient",

hippius_sdk/cli_handlers.py

@@ -102,20 +102,38 @@ def create_client(args: Any) -> HippiusClient:
     # Get substrate URL
     substrate_url = args.substrate_url if hasattr(args, "substrate_url") else None
 
-    # Skip password if we're doing erasure-code with --no-publish
-    # This avoids prompting for password when we don't need to interact with the blockchain
+    # Determine if we need to use password based on the command
+    # Only use password for: store, download, delete, erasure-code (unless --no-publish), reconstruct
     password = None
-    if (
-        hasattr(args, "command")
-        and args.command == "erasure-code"
-        and hasattr(args, "no_publish")
-        and args.no_publish
-    ):
-        # Don't need a password in this case
-        password = None
-    else:
-        # Use password from args if provided
-        password = args.password if hasattr(args, "password") else None
+
+    # First check if password is provided as an argument
+    if hasattr(args, "password") and args.password:
+        password = args.password
+    # Otherwise, decide based on the command
+    elif hasattr(args, "command"):
+        command = args.command
+        needs_password = False
+
+        # Check if this is one of the commands that needs a password
+        if command in [
+            "store",
+            "store-dir",
+            "download",
+            "delete",
+            "delete-dir",
+            "reconstruct",
+        ]:
+            needs_password = True
+        # Special case for erasure-code - only needs password if we're publishing
+        elif command == "erasure-code" and not (
+            hasattr(args, "no_publish") and args.no_publish
+        ):
+            needs_password = True
+
+        # If this command doesn't need password access, set to empty string to skip prompting
+        if not needs_password:
+            # Use empty string to indicate "skip password prompt" to the config system
+            password = ""
 
     # Initialize client with provided parameters
     client = HippiusClient(
@@ -692,27 +710,32 @@ async def handle_credits(
             ):
                 account_address = client.substrate_client._keypair.ss58_address
             else:
-                # Try to get the default address
-                default_address = get_default_address()
-                if default_address:
-                    account_address = default_address
-                else:
-                    has_default = get_default_address() is not None
-
-                    error("No account address provided, and client has no keypair.")
-
-                    if has_default:
-                        warning(
-                            "Please provide an account address with '--account_address' or the default address may be invalid."
-                        )
+                # Get the active account name and its address
+                from hippius_sdk.config import get_account_address, get_active_account
+
+                active_account = get_active_account()
+                if active_account:
+                    active_address = get_account_address(active_account)
+                    if active_address:
+                        account_address = active_address
                     else:
-                        warning(
-                            "Please provide an account address with '--account_address' or set a default with:"
+                        error(
+                            f"Active account '{active_account}' does not have a valid address."
                         )
-                        log(
-                            "  [bold green underline]hippius address set-default <your_account_address>[/bold green underline]"
+                        warning(
+                            "Please provide an account address with '--account_address'"
                         )
-
+                        return 1
+                else:
+                    error(
+                        "No account address provided, no active account set, and client has no keypair."
+                    )
+                    warning(
+                        "Please provide an account address with '--account_address' or set an active account with:"
+                    )
+                    log(
+                        "  [bold green underline]hippius account switch <account_name>[/bold green underline]"
+                    )
                     return 1
 
         credits = await client.substrate_client.get_free_credits(account_address)
@@ -3160,28 +3183,32 @@ async def handle_account_balance(
         ):
             account_address = client.substrate_client._keypair.ss58_address
         else:
-            # Try to get the default address
-            default_address = get_default_address()
-            if default_address:
-                account_address = default_address
-            else:
-                has_default = get_default_address() is not None
+            # Get the active account name and its address
+            from hippius_sdk.config import get_account_address, get_active_account
 
-                error("No account address provided, and client has no keypair.")
-
-                if has_default:
-                    warning(
-                        "Please provide an account address with '--account_address' or the default address may be invalid."
-                    )
+            active_account = get_active_account()
+            if active_account:
+                active_address = get_account_address(active_account)
+                if active_address:
+                    account_address = active_address
                 else:
-                    warning(
-                        "Please provide an account address with '--account_address' or set a default with:"
+                    error(
+                        f"Active account '{active_account}' does not have a valid address."
                     )
-                    log(
-                        "  hippius address set-default <your_account_address>",
-                        style="bold blue",
+                    warning(
+                        "Please provide an account address with '--account_address'"
                     )
-
+                    return 1
+            else:
+                error(
+                    "No account address provided, no active account set, and client has no keypair."
+                )
+                warning(
+                    "Please provide an account address with '--account_address' or set an active account with:"
+                )
+                log(
+                    "  [bold green underline]hippius account switch <account_name>[/bold green underline]"
+                )
                 return 1
 
     # Get the account balance

hippius_sdk/client.py

@@ -85,13 +85,15 @@ class HippiusClient:
         # Initialize Substrate client
         self.substrate_client = SubstrateClient(
             url=substrate_url,
-            seed_phrase=substrate_seed_phrase,
             password=seed_phrase_password,
             account_name=account_name,
         )
 
     async def upload_file(
-        self, file_path: str, encrypt: Optional[bool] = None
+        self,
+        file_path: str,
+        encrypt: Optional[bool] = None,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Upload a file to IPFS with optional encryption.
@@ -99,6 +101,7 @@ class HippiusClient:
         Args:
             file_path: Path to the file to upload
             encrypt: Whether to encrypt the file (overrides default)
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict[str, Any]: Dictionary containing file details including:
@@ -114,10 +117,15 @@ class HippiusClient:
             ValueError: If encryption is requested but not available
         """
         # Use the enhanced IPFSClient method directly with encryption parameter
-        return await self.ipfs_client.upload_file(file_path, encrypt=encrypt)
+        return await self.ipfs_client.upload_file(
+            file_path, encrypt=encrypt, seed_phrase=seed_phrase
+        )
 
     async def upload_directory(
-        self, dir_path: str, encrypt: Optional[bool] = None
+        self,
+        dir_path: str,
+        encrypt: Optional[bool] = None,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Upload a directory to IPFS with optional encryption.
@@ -125,6 +133,7 @@ class HippiusClient:
         Args:
             dir_path: Path to the directory to upload
             encrypt: Whether to encrypt files (overrides default)
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict[str, Any]: Dictionary containing directory details including:
@@ -141,10 +150,16 @@ class HippiusClient:
             ValueError: If encryption is requested but not available
         """
         # Use the enhanced IPFSClient method directly with encryption parameter
-        return await self.ipfs_client.upload_directory(dir_path, encrypt=encrypt)
+        return await self.ipfs_client.upload_directory(
+            dir_path, encrypt=encrypt, seed_phrase=seed_phrase
+        )
 
     async def download_file(
-        self, cid: str, output_path: str, decrypt: Optional[bool] = None
+        self,
+        cid: str,
+        output_path: str,
+        decrypt: Optional[bool] = None,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Download a file from IPFS with optional decryption.
@@ -154,6 +169,7 @@ class HippiusClient:
             cid: Content Identifier (CID) of the file to download
             output_path: Path where the downloaded file/directory will be saved
             decrypt: Whether to decrypt the file (overrides default)
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict[str, Any]: Dictionary containing download details including:
@@ -169,7 +185,9 @@ class HippiusClient:
             requests.RequestException: If the download fails
             ValueError: If decryption is requested but fails
         """
-        return await self.ipfs_client.download_file(cid, output_path, _=decrypt)
+        return await self.ipfs_client.download_file(
+            cid, output_path, _=decrypt, seed_phrase=seed_phrase
+        )
 
     async def cat(
         self,
@@ -177,6 +195,7 @@ class HippiusClient:
         max_display_bytes: int = 1024,
         format_output: bool = True,
         decrypt: Optional[bool] = None,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Get the content of a file from IPFS with optional decryption.
@@ -186,6 +205,7 @@ class HippiusClient:
             max_display_bytes: Maximum number of bytes to include in the preview
             format_output: Whether to attempt to decode the content as text
             decrypt: Whether to decrypt the file (overrides default)
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict[str, Any]: Dictionary containing content details including:
@@ -197,15 +217,22 @@ class HippiusClient:
                 - decrypted: Whether the file was decrypted
         """
         return await self.ipfs_client.cat(
-            cid, max_display_bytes, format_output, decrypt=decrypt
+            cid,
+            max_display_bytes,
+            format_output,
+            decrypt=decrypt,
+            seed_phrase=seed_phrase,
         )
 
-    async def exists(self, cid: str) -> Dict[str, Any]:
+    async def exists(
+        self, cid: str, seed_phrase: Optional[str] = None
+    ) -> Dict[str, Any]:
         """
         Check if a CID exists on IPFS.
 
         Args:
             cid: Content Identifier (CID) to check
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict[str, Any]: Dictionary containing:
@@ -214,14 +241,15 @@ class HippiusClient:
                 - formatted_cid: Formatted version of the CID
                 - gateway_url: URL to access the content if it exists
         """
-        return await self.ipfs_client.exists(cid)
+        return await self.ipfs_client.exists(cid, seed_phrase=seed_phrase)
 
-    async def pin(self, cid: str) -> Dict[str, Any]:
+    async def pin(self, cid: str, seed_phrase: Optional[str] = None) -> Dict[str, Any]:
         """
         Pin a CID to IPFS to keep it available.
 
         Args:
             cid: Content Identifier (CID) to pin
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict[str, Any]: Dictionary containing:
@@ -230,7 +258,7 @@ class HippiusClient:
                 - formatted_cid: Formatted version of the CID
                 - message: Status message
         """
-        return await self.ipfs_client.pin(cid)
+        return await self.ipfs_client.pin(cid, seed_phrase=seed_phrase)
 
     def format_cid(self, cid: str) -> str:
         """
@@ -293,6 +321,7 @@ class HippiusClient:
         encrypt: Optional[bool] = None,
         max_retries: int = 3,
         verbose: bool = True,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Split a file using erasure coding, then upload the chunks to IPFS.
@@ -310,6 +339,7 @@ class HippiusClient:
             encrypt: Whether to encrypt the file before encoding (defaults to self.encrypt_by_default)
             max_retries: Maximum number of retry attempts for IPFS uploads
             verbose: Whether to print progress information
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             dict: Metadata including the original file info and chunk information
@@ -326,6 +356,7 @@ class HippiusClient:
             encrypt=encrypt,
             max_retries=max_retries,
             verbose=verbose,
+            seed_phrase=seed_phrase,
         )
 
     async def reconstruct_from_erasure_code(
@@ -335,6 +366,7 @@ class HippiusClient:
         temp_dir: str = None,
         max_retries: int = 3,
         verbose: bool = True,
+        seed_phrase: Optional[str] = None,
     ) -> Dict:
         """
         Reconstruct a file from erasure-coded chunks using its metadata.
@@ -345,6 +377,7 @@ class HippiusClient:
             temp_dir: Directory to use for temporary files (default: system temp)
             max_retries: Maximum number of retry attempts for IPFS downloads
             verbose: Whether to print progress information
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict: containing file reconstruction info.
@@ -359,6 +392,7 @@ class HippiusClient:
             temp_dir=temp_dir,
             max_retries=max_retries,
             verbose=verbose,
+            seed_phrase=seed_phrase,
         )
 
     async def store_erasure_coded_file(
@@ -373,6 +407,7 @@ class HippiusClient:
         verbose: bool = True,
         progress_callback: Optional[Callable[[str, int, int], None]] = None,
         publish: bool = True,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Erasure code a file, upload the chunks to IPFS, and store in the Hippius marketplace.
@@ -393,6 +428,7 @@ class HippiusClient:
             publish: Whether to publish to the blockchain (True) or just perform local
                     erasure coding without publishing (False). When False, no password
                     is needed for seed phrase access.
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             dict: Result including metadata CID and transaction hash (if published)
@@ -413,10 +449,14 @@ class HippiusClient:
             verbose=verbose,
             progress_callback=progress_callback,
             publish=publish,
+            seed_phrase=seed_phrase,
         )
 
     async def delete_file(
-        self, cid: str, cancel_from_blockchain: bool = True
+        self,
+        cid: str,
+        cancel_from_blockchain: bool = True,
+        seed_phrase: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Delete a file from IPFS and optionally cancel its storage on the blockchain.
@@ -424,6 +464,7 @@ class HippiusClient:
         Args:
             cid: Content Identifier (CID) of the file to delete
             cancel_from_blockchain: Whether to also cancel the storage request from the blockchain
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             Dict containing the result of the operation
@@ -431,13 +472,16 @@ class HippiusClient:
         Raises:
             RuntimeError: If deletion fails completely
         """
-        return await self.ipfs_client.delete_file(cid, cancel_from_blockchain)
+        return await self.ipfs_client.delete_file(
+            cid, cancel_from_blockchain, seed_phrase=seed_phrase
+        )
 
     async def delete_ec_file(
         self,
         metadata_cid: str,
         cancel_from_blockchain: bool = True,
         parallel_limit: int = 20,
+        seed_phrase: Optional[str] = None,
     ) -> bool:
         """
         Delete an erasure-coded file, including all its chunks in parallel.
@@ -446,6 +490,7 @@ class HippiusClient:
             metadata_cid: CID of the metadata file for the erasure-coded file
             cancel_from_blockchain: Whether to cancel storage from blockchain
             parallel_limit: Maximum number of concurrent deletion operations
+            seed_phrase: Optional seed phrase to use for blockchain interactions (uses config if None)
 
         Returns:
             True or false if failed.
@@ -454,5 +499,8 @@ class HippiusClient:
             RuntimeError: If deletion fails completely
         """
         return await self.ipfs_client.delete_ec_file(
-            metadata_cid, cancel_from_blockchain, parallel_limit
+            metadata_cid,
+            cancel_from_blockchain,
+            parallel_limit,
+            seed_phrase=seed_phrase,
         )

hippius_sdk/config.py

@@ -380,7 +380,7 @@ def decrypt_seed_phrase(
     Decrypt the substrate seed phrase using password-based decryption.
 
     Args:
-        password: Optional password (if None, will prompt)
+        password: Optional password (if None, will prompt; if empty string, will skip password for read-only operations)
         account_name: Optional account name (if None, uses active account)
 
     Returns:
@@ -412,6 +412,12 @@ def decrypt_seed_phrase(
         print("Error: No encrypted seed phrase found or missing salt")
         return None
 
+    # Check if we're in skip-password mode (empty string)
+    # This is used for read-only operations that don't need blockchain interaction
+    if password == "":
+        # Don't print a message as it's confusing to the user
+        return None
+
     # Get password from user if not provided
     if password is None:
         password = getpass.getpass("Enter password to decrypt seed phrase: \n\n")
@@ -427,7 +433,8 @@ def get_seed_phrase(
     Get the substrate seed phrase from configuration, decrypting if necessary.
 
     Args:
-        password: Optional password for decryption (if None and needed, will prompt)
+        password: Optional password for decryption (if None and needed, will prompt;
+                if empty string, will skip decryption for read-only operations)
         account_name: Optional account name (if None, uses active account)
 
     Returns:
@@ -449,6 +456,11 @@ def get_seed_phrase(
     account_data = config["substrate"]["accounts"][name_to_use]
     is_encoded = account_data.get("seed_phrase_encoded", False)
 
+    # If password is an empty string, this indicates we're doing a read-only operation
+    # that doesn't require the seed phrase, so we can return None
+    if password == "" and is_encoded:
+        return None
+
     if is_encoded:
         return decrypt_seed_phrase(password, name_to_use)
     else: