hippius 0.2.6__py3-none-any.whl → 0.2.8__py3-none-any.whl

{hippius-0.2.6.dist-info → hippius-0.2.8.dist-info}/METADATA

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

{hippius-0.2.6.dist-info → hippius-0.2.8.dist-info}/RECORD

@@ -1,8 +1,8 @@
-hippius_sdk/__init__.py,sha256=n3IvS-VlVHsBq7HFCSgQvFcJ4ZTvs8MNfwrETRM6WBM,1391
-hippius_sdk/cli.py,sha256=lpiokB5wt5nqcGOkvg62NNWr1l4ky9xCM53d14PyGWw,17907
+hippius_sdk/__init__.py,sha256=qXKCaurObaxcmP718Q9X2nSROm3ZYaetT3sR69fPcSI,1391
+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=GEjVFKIfXL0MYJiNQSdMovtqv2MheIN9ftq7z4VpPhU,120889
-hippius_sdk/cli_parser.py,sha256=fU4kIeNM4an6FtyVX13-u33MmO70PrNzvmPe2ZtPf-0,19576
+hippius_sdk/cli_handlers.py,sha256=LUS-BPPMfvXCLsHiN225nMTlBEHXKxZmUf1YpC-Xyqc,127905
+hippius_sdk/cli_parser.py,sha256=Qh2wgkFBUTPldvGoTQuoNKQl5Vo0x6fPEsPBU5oymP4,20242
 hippius_sdk/cli_rich.py,sha256=_jTBYMdHi2--fIVwoeNi-EtkdOb6Zy_O2TUiGvU3O7s,7324
 hippius_sdk/client.py,sha256=eYURsq_so3WlEt_JY_u7J0iECFVOKDf5vsnGyR9Kngw,16974
 hippius_sdk/config.py,sha256=sCWD2remLa-FodvxC2O45tiNSJD7gzv9idIStX9sF_k,21240
@@ -11,7 +11,7 @@ hippius_sdk/ipfs.py,sha256=xq0y87dyKvbwf52OjEAlqFNrl4Ej1Zp5g2rZa75qfN8,71706
 hippius_sdk/ipfs_core.py,sha256=Lxu2-AWEpE-kiJDcP-cOBEeuboK7i9eNZdjgJWPa4sI,16028
 hippius_sdk/substrate.py,sha256=HqR2-_9njZZ5UCKgiaGr5L5TGQ_wtj7oyA3sA5sGGyE,47525
 hippius_sdk/utils.py,sha256=Ur7P_7iVnXXYvbg7a0aVrdN_8NkVxjhdngn8NzR_zpc,7066
-hippius-0.2.6.dist-info/METADATA,sha256=OnPIZTwaJ-DtBYDYhVjEwGAoC13_0rSgWs7jDLaIAHQ,29992
-hippius-0.2.6.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-hippius-0.2.6.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
-hippius-0.2.6.dist-info/RECORD,,
+hippius-0.2.8.dist-info/METADATA,sha256=8XQCTdk2Yw6HGik6V3GSj6S1qt_-yqM00PT5Q5EcBV8,29992
+hippius-0.2.8.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+hippius-0.2.8.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
+hippius-0.2.8.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.6"
+__version__ = "0.2.8"
 __all__ = [
     "HippiusClient",
     "IPFSClient",

hippius_sdk/cli.py

@@ -236,6 +236,15 @@ def main():
                 force=args.force if hasattr(args, "force") else False,
             )
 
+        elif args.command == "pin":
+            return run_async_handler(
+                cli_handlers.handle_pin,
+                client,
+                args.cid,
+                publish=not args.no_publish if hasattr(args, "no_publish") else True,
+                miner_ids=miner_ids,
+            )
+
         elif args.command == "ec-delete":
             return run_async_handler(
                 cli_handlers.handle_ec_delete,

hippius_sdk/cli_handlers.py

@@ -371,20 +371,22 @@ async def handle_store(
                             "gateway_url"
                         ] = f"{client.ipfs_client.gateway}/ipfs/{result['cid']}"
 
-                    # Store on blockchain if miners are provided
-                    if miner_ids:
-                        # Create a file input for blockchain storage
-                        file_input = FileInput(
-                            file_hash=result["cid"], file_name=file_name
-                        )
+                    # Store on blockchain - miners are optional
+                    # Create a file input for blockchain storage
+                    file_input = FileInput(file_hash=result["cid"], file_name=file_name)
 
-                        # Submit storage request
-                        tx_hash = await client.substrate_client.storage_request(
-                            files=[file_input], miner_ids=miner_id_list
-                        )
+                    # Submit storage request
+                    tx_hash = await client.substrate_client.storage_request(
+                        files=[file_input], miner_ids=miner_id_list
+                    )
 
-                        # Add transaction hash to result
-                        result["transaction_hash"] = tx_hash
+                    # Add transaction hash to result
+                    result["transaction_hash"] = tx_hash
+
+                    # Add a note about the pinning status command
+                    log(
+                        "\n[bold yellow]Note:[/bold yellow] The pinning-status command will show a different CID (metadata) rather than the direct file CID."
+                    )
                 except Exception as e:
                     warning(f"Failed to publish file globally: {str(e)}")
 
@@ -575,12 +577,8 @@ async def handle_store_dir(
                                     f"Failed to publish file {file_info['name']} globally: {str(e)}"
                                 )
 
-                    # Store on blockchain if miners are provided - this is what requires a password
-                    if (
-                        miner_ids
-                        and hasattr(client, "substrate_client")
-                        and client.substrate_client
-                    ):
+                    # Store on blockchain if client is available - miners are optional
+                    if hasattr(client, "substrate_client") and client.substrate_client:
                         # Create a file input for blockchain storage
                         file_input = FileInput(
                             file_hash=result["cid"],
@@ -595,6 +593,11 @@ async def handle_store_dir(
                         # Add transaction hash to result
                         result["transaction_hash"] = tx_hash
 
+                        # Add a note about the pinning status command
+                        log(
+                            "\n[bold yellow]Note:[/bold yellow] The pinning-status command will show a different CID (metadata) rather than the direct directory CID."
+                        )
+
                 except Exception as e:
                     warning(f"Failed to publish directory globally: {str(e)}")
 
@@ -739,20 +742,32 @@ async def handle_files(
     """Handle the files command"""
     # Get the account address we're querying
     if account_address is None:
-        # If no address provided, first try to get from keypair (if available)
+        # If no address provided, try these options in order:
+        # 1. Keypair from the client (if available)
+        # 2. Address from active account
+        # 3. Default address from config
+
+        # Option 1: Try keypair from client
         if (
             hasattr(client.substrate_client, "_keypair")
             and client.substrate_client._keypair is not None
         ):
             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
+            # Option 2: Try to get address from active account
+            active_account = get_active_account()
+            if active_account:
+                account_address = get_account_address(active_account)
 
+            # Option 3: If still not found, try default address
+            if not account_address:
+                default_address = get_default_address()
+                if default_address:
+                    account_address = default_address
+
+            # If we still don't have an address, show error
+            if not account_address:
+                has_default = get_default_address() is not None
                 error("No account address provided, and client has no keypair.")
 
                 if has_default:
@@ -842,7 +857,7 @@ async def handle_pinning_status(
                 cid = pin.get("cid")
 
                 # Display pin information
-                log(f"\n{i}. CID: [bold]{cid}[/bold]")
+                log(f"\n{i}. Metadata CID: [bold]{cid}[/bold]")
                 log(f"   File Name: {pin['file_name']}")
                 status = "Assigned" if pin["is_assigned"] else "Pending"
                 log(f"   Status: {status}")
@@ -861,17 +876,49 @@ async def handle_pinning_status(
 
                 # Show content info if requested
                 if show_contents:
+                    # Add gateway URL
+                    gateway_url = f"{client.ipfs_client.gateway}/ipfs/{cid}"
+                    log(f"   Gateway URL: {gateway_url}")
+
+                    # Try to decode the metadata file to get the original file CID
                     try:
-                        content_info = await client.ipfs_client.get_content_info(cid)
+                        # Fetch the content
+                        cat_result = await client.ipfs_client.cat(cid)
 
-                        if content_info:
-                            if "size_formatted" in content_info:
-                                log(f"   Size: {content_info['size_formatted']}")
-                            if "gateway_url" in content_info:
-                                log(f"   Gateway URL: {content_info['gateway_url']}")
+                        # Try to parse as JSON
+                        try:
+                            # Decode JSON from content
+                            metadata_json = json.loads(
+                                cat_result["content"].decode("utf-8")
+                            )
+
+                            # This should be an array with one or more file entries
+                            if (
+                                isinstance(metadata_json, list)
+                                and len(metadata_json) > 0
+                            ):
+                                log(f"\n   [bold cyan]Contained files:[/bold cyan]")
+                                for idx, file_entry in enumerate(metadata_json, 1):
+                                    if isinstance(file_entry, dict):
+                                        original_cid = file_entry.get("cid")
+                                        original_name = file_entry.get("filename")
+                                        if original_cid:
+                                            log(
+                                                f"   {idx}. Original CID: [bold green]{original_cid}[/bold green]"
+                                            )
+                                            if original_name:
+                                                log(f"      Name: {original_name}")
+                                            log(
+                                                f"      Gateway URL: {client.ipfs_client.gateway}/ipfs/{original_cid}"
+                                            )
+                        except json.JSONDecodeError:
+                            if verbose:
+                                log(
+                                    "   [yellow]Could not parse metadata as JSON[/yellow]"
+                                )
                     except Exception as e:
                         if verbose:
-                            warning(f"   Error getting content info: {e}")
+                            warning(f"   Error getting original file CIDs: {e}")
             except Exception as e:
                 warning(f"Error processing pin {i}: {e}")
                 if verbose:
@@ -1713,6 +1760,117 @@ async def handle_delete(client: HippiusClient, cid: str, force: bool = False) ->
     return 0
 
 
+async def handle_pin(
+    client: HippiusClient, cid: str, publish: bool = True, miner_ids=None
+) -> int:
+    """Handle the pin command to pin a CID to IPFS and optionally publish to blockchain"""
+    from rich.panel import Panel
+
+    # First check if this CID exists
+    try:
+        exists_result = await client.exists(cid)
+        if not exists_result["exists"]:
+            error(f"CID [bold cyan]{cid}[/bold cyan] not found on IPFS")
+            return 1
+    except Exception as e:
+        warning(f"Error checking if CID exists: {e}")
+        return 1
+
+    # Create operation title based on publish flag
+    if publish:
+        info(
+            f"Preparing to pin and publish content with CID: [bold cyan]{cid}[/bold cyan]"
+        )
+        operation_title = "Pin & Publish Operation"
+    else:
+        info(f"Preparing to pin content with CID: [bold cyan]{cid}[/bold cyan]")
+        operation_title = "Pin Operation"
+
+    # Display operation details
+    operation_details = [
+        f"CID: [bold cyan]{cid}[/bold cyan]",
+        f"Publishing to blockchain: {'Enabled' if publish else 'Disabled'}",
+    ]
+    print_panel("\n".join(operation_details), title=operation_title)
+
+    # Need to authenticate if publishing to blockchain
+    if publish:
+        try:
+            # Ensure we have a keypair for substrate operations
+            _ = client.substrate_client._ensure_keypair()
+        except Exception as e:
+            warning(f"Failed to initialize blockchain client: {str(e)}")
+            warning("Will continue with pinning but blockchain publishing may fail")
+
+    # Show spinner during pinning
+    with console.status(
+        "[cyan]Pinning content to IPFS...[/cyan]", spinner="dots"
+    ) as status:
+        try:
+            # Pin the content to IPFS
+            pin_result = await client.ipfs_client.pin(cid)
+
+            if not pin_result.get("success", False):
+                error(
+                    f"Failed to pin content: {pin_result.get('message', 'Unknown error')}"
+                )
+                return 1
+
+            # If publishing to blockchain, do that now
+            if publish:
+                status.update("[cyan]Publishing content to blockchain...[/cyan]")
+
+                # Create a FileInput object for the substrate client
+                from hippius_sdk.substrate import FileInput
+
+                file_input = FileInput(file_hash=cid, file_name=f"pinned_{cid}")
+
+                # Submit the storage request
+                tx_hash = await client.substrate_client.storage_request(
+                    files=[file_input], miner_ids=miner_ids
+                )
+
+                # Create result panel with blockchain details
+                gateway_url = f"{client.ipfs_client.gateway}/ipfs/{cid}"
+                panel_details = [
+                    f"Successfully pinned and published: [bold cyan]{cid}[/bold cyan]",
+                    f"Gateway URL: [bold cyan]{gateway_url}[/bold cyan]",
+                    f"Transaction hash: [bold green]{tx_hash}[/bold green]",
+                    "\nThis content is now:",
+                    "1. Pinned to your IPFS node",
+                    "2. Published to the IPFS network",
+                    "3. Stored on the Hippius blockchain",
+                ]
+                console.print(
+                    Panel(
+                        "\n".join(panel_details),
+                        title="Operation Complete",
+                        border_style="green",
+                    )
+                )
+            else:
+                # Just pinning, no blockchain publishing
+                gateway_url = f"{client.ipfs_client.gateway}/ipfs/{cid}"
+                panel_details = [
+                    f"Successfully pinned: [bold cyan]{cid}[/bold cyan]",
+                    f"Gateway URL: [bold cyan]{gateway_url}[/bold cyan]",
+                    "\nThis content is now pinned to your IPFS node.",
+                    "It will remain available as long as your node is running.",
+                ]
+                console.print(
+                    Panel(
+                        "\n".join(panel_details),
+                        title="Pinning Complete",
+                        border_style="green",
+                    )
+                )
+
+            return 0
+        except Exception as e:
+            error(f"Error during operation: {e}")
+            return 1
+
+
 async def handle_ec_delete(
     client: HippiusClient, metadata_cid: str, force: bool = False
 ) -> int:

hippius_sdk/cli_parser.py

@@ -63,13 +63,19 @@ examples:
   
   # Erasure code without publishing to global IPFS network
   hippius erasure-code large_file.avi --no-publish
-  
+
   # Reconstruct an erasure-coded file
   hippius reconstruct QmMetadataHash reconstructed_file.mp4
-  
+
+  # Pin a CID to IPFS and publish to blockchain
+  hippius pin QmHash
+
+  # Pin a CID to IPFS without publishing to blockchain
+  hippius pin QmHash --no-publish
+
   # Delete a file from IPFS and marketplace
   hippius delete QmHash
-  
+
   # Delete an erasure-coded file and all its chunks
   hippius ec-delete QmMetadataHash
 """,
@@ -250,6 +256,23 @@ def add_storage_commands(subparsers):
         help="Delete without confirmation prompt",
     )
 
+    # Pin command
+    pin_parser = subparsers.add_parser(
+        "pin",
+        help="Pin a CID to IPFS and publish to blockchain",
+    )
+    pin_parser.add_argument("cid", help="CID to pin")
+    pin_parser.add_argument(
+        "--publish",
+        action="store_true",
+        help="Publish file to IPFS and store on the blockchain (default)",
+    )
+    pin_parser.add_argument(
+        "--no-publish",
+        action="store_true",
+        help="Don't publish file to blockchain (local pinning only)",
+    )
+
     # Keygen command
     keygen_parser = subparsers.add_parser(
         "keygen", help="Generate an encryption key for secure file storage"