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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hippius
-Version: 0.2.6
+Version: 0.2.7
 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.7.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=t0Lg5aOSqwtAWhW8wgmVeB4IdJvUTv7Pb77vCTP0KAE,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=xSFMGrgQRoatFgkk0CpM9h5q6URUzAol3xHGCdFHKxE,125258
+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.7.dist-info/METADATA,sha256=dNUAXbSVYGvEKLsFvTpdF_SIa3B1fM9pnm7FQzJduB8,29992
+hippius-0.2.7.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+hippius-0.2.7.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
+hippius-0.2.7.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.7"
 __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

@@ -1713,6 +1713,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"