hippius 0.2.48__py3-none-any.whl → 0.2.50__py3-none-any.whl

{hippius-0.2.48.dist-info → hippius-0.2.50.dist-info}/METADATA

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

{hippius-0.2.48.dist-info → hippius-0.2.50.dist-info}/RECORD

@@ -1,8 +1,8 @@
-hippius_sdk/__init__.py,sha256=AiRoiySW_2WO5IKG__Z_MYFakK1gmdfLzgocYj3Va0A,1474
-hippius_sdk/cli.py,sha256=aqKOYSBSWt7UhcpFt7wf9yIPJ3bznpsJ6ehOnuZ4usI,18235
+hippius_sdk/__init__.py,sha256=W3hzhHCetgr_Eoa1Q8xbgW1pYYYhJUi3vZ9FrNRm5_A,1474
+hippius_sdk/cli.py,sha256=eGxStdSNtO0dR-zgDajJZUCGqEzeo2xaQQfdFrvPmBQ,20546
 hippius_sdk/cli_assets.py,sha256=rjH3Z5A1CQr2d5CIAAAb0WMCjoZZlMWcdo0f93KqluE,635
-hippius_sdk/cli_handlers.py,sha256=HkZldE8ZDS6WHu8aSoeS_rYZ4kp3F-Kdzu-weY1c0vU,128258
-hippius_sdk/cli_parser.py,sha256=z7UvgWvvy04ey-R56qZiCqYc_9RaNq1rVDkQyXoK3JU,21100
+hippius_sdk/cli_handlers.py,sha256=iDDLswdNmeBVp09h7JWCXt3XyFlRqJ9efVdGWXSMC2E,143422
+hippius_sdk/cli_parser.py,sha256=uYd_k6wBN3UyFJyJ-rRcvAzQNFoHaW28AkiBq8f6aco,26025
 hippius_sdk/cli_rich.py,sha256=_jTBYMdHi2--fIVwoeNi-EtkdOb6Zy_O2TUiGvU3O7s,7324
 hippius_sdk/client.py,sha256=6W50r7-WcMyZNI1j3NOKMpcSMlB819AMKM9w06YqMx0,24302
 hippius_sdk/config.py,sha256=Hf_aUYzG9ylzqauA_ABUSSB5mBTYbp-VtB36VQt2XDw,21981
@@ -13,12 +13,13 @@ hippius_sdk/db/migrations/20241202000001_switch_to_subaccount_encryption.sql,sha
 hippius_sdk/db/setup_database.sh,sha256=STp03qxkp2RmIVr6YZIcvQQm-_LLUOb6Jobh-52HWmg,3115
 hippius_sdk/db_utils.py,sha256=-x0rbN0as7Tn3PJPZBYCgreZe52FLH40ppA1TLxsg90,1851
 hippius_sdk/errors.py,sha256=LScJJmawVAx7aRzqqQguYSkf9iazSjEQEBNlD_GXZ6Y,1589
+hippius_sdk/incentives.py,sha256=0_xpaxNBmbK-0mvTm87vwBaZF-daM7hxm0dKYgkuXh4,16908
 hippius_sdk/ipfs.py,sha256=c4tfS5VymZYph9yXuFr40teefyVi7APq9oIpFiIXlDI,104651
 hippius_sdk/ipfs_core.py,sha256=xsY0Ox6anmrkbrxkRr2RXzEukB-EEaW_oMvO0Va3vjQ,13148
 hippius_sdk/key_storage.py,sha256=HWV9mM5Zkq_xxn7A72L7gvlYBtcmMwOyeFdtl8ExlmE,8315
 hippius_sdk/substrate.py,sha256=4a7UIE4UqGcDW7luKTBgSDqfb2OIZusB39G1UiRs_YU,50158
 hippius_sdk/utils.py,sha256=rJ611yvwKSyiBpYU3w-SuyQxoghMGU-ePuslrPv5H5g,7388
-hippius-0.2.48.dist-info/METADATA,sha256=1PAHyZ4VTndg9W1qoG24yLc_TDWUOsCosWwUHsVebmE,30088
-hippius-0.2.48.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-hippius-0.2.48.dist-info/entry_points.txt,sha256=bFAZjW3vndretf9-8s587jA2ebMVI7puhn_lVs8jPc8,149
-hippius-0.2.48.dist-info/RECORD,,
+hippius-0.2.50.dist-info/METADATA,sha256=KHFUTYzy_C2mHhS0hWs-GW5CCddxce7tM-N1jfZDPDc,30088
+hippius-0.2.50.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+hippius-0.2.50.dist-info/entry_points.txt,sha256=bFAZjW3vndretf9-8s587jA2ebMVI7puhn_lVs8jPc8,149
+hippius-0.2.50.dist-info/RECORD,,

hippius_sdk/__init__.py

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

hippius_sdk/cli.py

@@ -409,6 +409,53 @@ def main():
                 print_help_text(address_parser)
                 return 1
 
+        # Handle miner commands
+        elif args.command == "miner":
+            if args.miner_action == "register-coldkey":
+                return run_async_handler(
+                    cli_handlers.handle_register_coldkey,
+                    client,
+                    args.node_id,
+                    args.node_priv_hex,
+                    args.node_type,
+                    ipfs_config=getattr(args, "ipfs_config", None),
+                    ipfs_priv_b64=getattr(args, "ipfs_priv_b64", None),
+                    ipfs_peer_id=getattr(args, "ipfs_peer_id", None),
+                    pay_in_credits=getattr(args, "pay_in_credits", False),
+                    expires_in=getattr(args, "expires_in", 10),
+                    block_width=getattr(args, "block_width", "u32"),
+                    domain=getattr(args, "domain", "HIPPIUS::REGISTER::v1"),
+                    nonce_hex=getattr(args, "nonce_hex", None),
+                    dry_run=getattr(args, "dry_run", False),
+                )
+            elif args.miner_action == "register-hotkey":
+                return run_async_handler(
+                    cli_handlers.handle_register_hotkey,
+                    client,
+                    args.coldkey,
+                    args.node_id,
+                    args.node_priv_hex,
+                    args.node_type,
+                    ipfs_config=getattr(args, "ipfs_config", None),
+                    ipfs_priv_b64=getattr(args, "ipfs_priv_b64", None),
+                    ipfs_peer_id=getattr(args, "ipfs_peer_id", None),
+                    pay_in_credits=getattr(args, "pay_in_credits", False),
+                    expires_in=getattr(args, "expires_in", 10),
+                    block_width=getattr(args, "block_width", "u32"),
+                    domain=getattr(args, "domain", "HIPPIUS::REGISTER::v1"),
+                    nonce_hex=getattr(args, "nonce_hex", None),
+                    dry_run=getattr(args, "dry_run", False),
+                )
+            else:
+                # Display the Hippius logo banner with Rich formatting
+                console.print(HERO_TITLE, style="bold cyan")
+
+                miner_parser = get_subparser("miner")
+                from hippius_sdk.cli_rich import print_help_text
+
+                print_help_text(miner_parser)
+                return 1
+
         else:
             # Command not recognized
             error(f"Unknown command: [bold]{args.command}[/bold]")

hippius_sdk/cli_handlers.py

@@ -3291,3 +3291,432 @@ def handle_default_address_clear() -> int:
     except Exception as e:
         error(f"Error clearing default address: {e}")
         return 1
+
+
+def handle_register_coldkey(
+    client: HippiusClient,
+    node_id: str,
+    node_priv_hex: str,
+    node_type: str,
+    ipfs_config: str = None,
+    ipfs_priv_b64: str = None,
+    ipfs_peer_id: str = None,
+    pay_in_credits: bool = False,
+    expires_in: int = 10,
+    block_width: str = "u32",
+    domain: str = "HIPPIUS::REGISTER::v1",
+    nonce_hex: str = None,
+    dry_run: bool = False,
+) -> int:
+    """Handle miner register-coldkey command"""
+    try:
+        # Get current account info
+        account = get_active_account()
+        if not account:
+            error(
+                "No active account. Please set up an account first with 'hippius account create' or 'hippius seed set'"
+            )
+            return 1
+
+        account_address = get_account_address(account)
+        if not account_address:
+            error(f"Could not get address for account '{account}'")
+            return 1
+
+        info(
+            f"Registering node with coldkey using account: [bold cyan]{account}[/bold cyan] ({account_address})"
+        )
+
+        # Import and use incentives.py functionality
+        from hippius_sdk.incentives import (
+            load_ipfs_seed,
+            load_main_seed,
+            encode_account_id,
+            verify_peer_id,
+            blake2_256,
+            manual_encode_challenge,
+            get_peer_id_from_public_key,
+            get_public_key_from_peer_id,
+        )
+        from substrateinterface import SubstrateInterface, Keypair
+        from nacl.signing import SigningKey
+        import base58
+        import secrets
+        from binascii import hexlify
+
+        # Initialize SubstrateInterface
+        substrate = SubstrateInterface(url=client.substrate_client.url)
+
+        # Get genesis hash and current block
+        genesis_hash_hex = substrate.get_block_hash(0)
+        genesis_hash = bytes.fromhex(genesis_hash_hex[2:])
+        current_block_number = substrate.get_block_number(None)
+
+        log(f"Current block number: {current_block_number}")
+
+        # Process node_id
+        if node_id.startswith("0x"):
+            node_id_bytes = bytes.fromhex(node_id[2:])
+        else:
+            node_id_bytes = base58.b58decode(node_id)
+
+        # Load IPFS and main seeds
+        ipfs_seed, peerid_from_config = load_ipfs_seed(ipfs_config, ipfs_priv_b64)
+        main_seed = load_main_seed(node_priv_hex)
+
+        # Create signing keys
+        main_sk = SigningKey(main_seed)
+        main_pk = bytes(main_sk.verify_key)
+        ipfs_sk = SigningKey(ipfs_seed)
+        ipfs_pk = bytes(ipfs_sk.verify_key)
+
+        # Handle IPFS peer ID
+        if ipfs_peer_id:
+            ipfs_peer_id_bytes = base58.b58decode(ipfs_peer_id)
+        elif peerid_from_config:
+            ipfs_peer_id_bytes = base58.b58decode(peerid_from_config)
+        else:
+            if node_type in ["StorageMiner", "Validator"]:
+                error(
+                    "IPFS PeerID is required for StorageMiner and Validator node types"
+                )
+                return 1
+            ipfs_peer_id_bytes = b""
+
+        # Verify keys match node IDs
+        if not verify_peer_id(main_pk, node_id_bytes, "Ed25519"):
+            error("Main public key does not match node ID")
+            return 1
+
+        if ipfs_peer_id_bytes and not verify_peer_id(
+            ipfs_pk, ipfs_peer_id_bytes, "Ed25519"
+        ):
+            error("IPFS public key does not match peer ID")
+            return 1
+
+        # Create challenge data
+        domain_bytes = domain.encode()
+        domain24 = b"HIPPIUS::REGISTER::v1" + b"\x00" * 3
+        node_id_hash = blake2_256(node_id_bytes)
+        ipfs_peer_id_hash = blake2_256(ipfs_peer_id_bytes)
+
+        nonce = (
+            bytes.fromhex(nonce_hex[2:])
+            if nonce_hex and nonce_hex.startswith("0x")
+            else bytes.fromhex(nonce_hex)
+            if nonce_hex
+            else secrets.token_bytes(32)
+        )
+
+        expires_at_block = current_block_number + expires_in
+        account_bytes = encode_account_id(account_address)
+
+        challenge_data = {
+            "domain": domain24,
+            "genesis_hash": genesis_hash,
+            "account": account_bytes,
+            "node_id_hash": node_id_hash,
+            "ipfs_peer_id_hash": ipfs_peer_id_hash,
+            "block_number": current_block_number,
+            "nonce": nonce,
+            "expires_at": expires_at_block,
+        }
+
+        challenge_bytes = manual_encode_challenge(challenge_data, block_width)
+
+        # Sign challenge
+        main_sig = main_sk.sign(challenge_bytes).signature
+        ipfs_sig = ipfs_sk.sign(challenge_bytes).signature
+
+        # Build call parameters
+        call_params = {
+            "node_type": node_type,
+            "node_id": node_id,
+            "node_id_hex": "0x" + hexlify(node_id_bytes).decode(),
+            "pay_in_credits": pay_in_credits,
+            "ipfs_node_id": ipfs_peer_id,
+            "owner": account_address,
+            "ipfs_peer_id": ipfs_peer_id,
+            "ipfs_id_hex": "0x" + hexlify(ipfs_peer_id_bytes).decode(),
+            "main_key_type": "Ed25519",
+            "main_public_key": "0x" + main_pk.hex(),
+            "main_sig": "0x" + main_sig.hex(),
+            "ipfs_key_type": "Ed25519",
+            "ipfs_public_key": "0x" + ipfs_pk.hex(),
+            "ipfs_sig": "0x" + ipfs_sig.hex(),
+            "challenge_bytes": "0x" + challenge_bytes.hex(),
+        }
+
+        if dry_run:
+            log("Dry run mode - printing payload without submitting")
+            payload = {
+                "genesis_hash_hex": "0x" + genesis_hash.hex(),
+                "current_block_number": current_block_number,
+                "challenge_bytes_hex": "0x" + challenge_bytes.hex(),
+                "call_module": "Registration",
+                "call_function": "register_node_with_coldkey",
+                "call_params": call_params,
+            }
+            console.print(json.dumps(payload, indent=2))
+            return 0
+
+        # Get keypair for signing
+        from hippius_sdk.config import get_seed_phrase
+        seed_phrase = get_seed_phrase()
+        if not seed_phrase:
+            error("No seed phrase available for signing transaction")
+            return 1
+
+        kp = Keypair.create_from_uri(seed_phrase)
+
+        # Submit transaction
+        log("Submitting registration transaction...")
+        call = substrate.compose_call(
+            call_module="Registration",
+            call_function="register_node_with_coldkey",
+            call_params=call_params,
+        )
+        extrinsic = substrate.create_signed_extrinsic(call=call, keypair=kp)
+        receipt = substrate.submit_extrinsic(extrinsic, wait_for_inclusion=True)
+
+        result = {
+            "extrinsic_hash": receipt.extrinsic_hash,
+            "is_success": receipt.is_success,
+            "error_message": receipt.error_message,
+            "triggered_events": [str(event) for event in receipt.triggered_events],
+        }
+
+        if receipt.is_success:
+            success(f"Node registered successfully with coldkey!")
+            success(f"Transaction hash: {receipt.extrinsic_hash}")
+        else:
+            error(f"Registration failed: {receipt.error_message}")
+
+        log("Full result:")
+        console.print(json.dumps(result, indent=2))
+
+        return 0 if receipt.is_success else 1
+
+    except Exception as e:
+        error(f"Error registering node with coldkey: {e}")
+        if hasattr(e, "__traceback__"):
+            import traceback
+
+            traceback.print_exc()
+        return 1
+
+
+def handle_register_hotkey(
+    client: HippiusClient,
+    coldkey: str,
+    node_id: str,
+    node_priv_hex: str,
+    node_type: str,
+    ipfs_config: str = None,
+    ipfs_priv_b64: str = None,
+    ipfs_peer_id: str = None,
+    pay_in_credits: bool = False,
+    expires_in: int = 10,
+    block_width: str = "u32",
+    domain: str = "HIPPIUS::REGISTER::v1",
+    nonce_hex: str = None,
+    dry_run: bool = False,
+) -> int:
+    """Handle miner register-hotkey command"""
+    try:
+        # Get current account info
+        account = get_active_account()
+        if not account:
+            error(
+                "No active account. Please set up an account first with 'hippius account create' or 'hippius seed set'"
+            )
+            return 1
+
+        account_address = get_account_address(account)
+        if not account_address:
+            error(f"Could not get address for account '{account}'")
+            return 1
+
+        info(
+            f"Registering node with hotkey using account: [bold cyan]{account}[/bold cyan] ({account_address})"
+        )
+        info(f"Coldkey: [bold yellow]{coldkey}[/bold yellow]")
+
+        # Import and use incentives.py functionality
+        from hippius_sdk.incentives import (
+            load_ipfs_seed,
+            load_main_seed,
+            encode_account_id,
+            verify_peer_id,
+            blake2_256,
+            manual_encode_challenge,
+            get_peer_id_from_public_key,
+            get_public_key_from_peer_id,
+        )
+        from substrateinterface import SubstrateInterface, Keypair
+        from nacl.signing import SigningKey
+        import base58
+        import secrets
+        from binascii import hexlify
+
+        # Initialize SubstrateInterface
+        substrate = SubstrateInterface(url=client.substrate_client.url)
+
+        # Get genesis hash and current block
+        genesis_hash_hex = substrate.get_block_hash(0)
+        genesis_hash = bytes.fromhex(genesis_hash_hex[2:])
+        current_block_number = substrate.get_block_number(None)
+
+        log(f"Current block number: {current_block_number}")
+
+        # Process node_id
+        if node_id.startswith("0x"):
+            node_id_bytes = bytes.fromhex(node_id[2:])
+        else:
+            node_id_bytes = base58.b58decode(node_id)
+
+        # Load IPFS and main seeds
+        ipfs_seed, peerid_from_config = load_ipfs_seed(ipfs_config, ipfs_priv_b64)
+        main_seed = load_main_seed(node_priv_hex)
+
+        # Create signing keys
+        main_sk = SigningKey(main_seed)
+        main_pk = bytes(main_sk.verify_key)
+        ipfs_sk = SigningKey(ipfs_seed)
+        ipfs_pk = bytes(ipfs_sk.verify_key)
+
+        # Handle IPFS peer ID
+        if ipfs_peer_id:
+            ipfs_peer_id_bytes = base58.b58decode(ipfs_peer_id)
+        elif peerid_from_config:
+            ipfs_peer_id_bytes = base58.b58decode(peerid_from_config)
+        else:
+            if node_type in ["StorageMiner", "Validator"]:
+                error(
+                    "IPFS PeerID is required for StorageMiner and Validator node types"
+                )
+                return 1
+            ipfs_peer_id_bytes = b""
+
+        # Verify keys match node IDs
+        if not verify_peer_id(main_pk, node_id_bytes, "Ed25519"):
+            error("Main public key does not match node ID")
+            return 1
+
+        if ipfs_peer_id_bytes and not verify_peer_id(
+            ipfs_pk, ipfs_peer_id_bytes, "Ed25519"
+        ):
+            error("IPFS public key does not match peer ID")
+            return 1
+
+        # Create challenge data
+        domain_bytes = domain.encode()
+        domain24 = b"HIPPIUS::REGISTER::v1" + b"\x00" * 3
+        node_id_hash = blake2_256(node_id_bytes)
+        ipfs_peer_id_hash = blake2_256(ipfs_peer_id_bytes)
+
+        nonce = (
+            bytes.fromhex(nonce_hex[2:])
+            if nonce_hex and nonce_hex.startswith("0x")
+            else bytes.fromhex(nonce_hex)
+            if nonce_hex
+            else secrets.token_bytes(32)
+        )
+
+        expires_at_block = current_block_number + expires_in
+        account_bytes = encode_account_id(account_address)
+
+        challenge_data = {
+            "domain": domain24,
+            "genesis_hash": genesis_hash,
+            "account": account_bytes,
+            "node_id_hash": node_id_hash,
+            "ipfs_peer_id_hash": ipfs_peer_id_hash,
+            "block_number": current_block_number,
+            "nonce": nonce,
+            "expires_at": expires_at_block,
+        }
+
+        challenge_bytes = manual_encode_challenge(challenge_data, block_width)
+
+        # Sign challenge
+        main_sig = main_sk.sign(challenge_bytes).signature
+        ipfs_sig = ipfs_sk.sign(challenge_bytes).signature
+
+        # Build call parameters
+        call_params = {
+            "coldkey": coldkey,
+            "node_type": node_type,
+            "node_id": node_id,
+            "node_id_hex": "0x" + hexlify(node_id_bytes).decode(),
+            "pay_in_credits": pay_in_credits,
+            "ipfs_node_id": ipfs_peer_id,
+            "ipfs_peer_id": ipfs_peer_id,
+            "ipfs_id_hex": "0x" + hexlify(ipfs_peer_id_bytes).decode(),
+            "owner": account_address,
+            "main_key_type": "Ed25519",
+            "main_public_key": "0x" + main_pk.hex(),
+            "main_sig": "0x" + main_sig.hex(),
+            "ipfs_key_type": "Ed25519",
+            "ipfs_public_key": "0x" + ipfs_pk.hex(),
+            "ipfs_sig": "0x" + ipfs_sig.hex(),
+            "challenge_bytes": "0x" + challenge_bytes.hex(),
+        }
+
+        if dry_run:
+            log("Dry run mode - printing payload without submitting")
+            payload = {
+                "genesis_hash_hex": "0x" + genesis_hash.hex(),
+                "current_block_number": current_block_number,
+                "challenge_bytes_hex": "0x" + challenge_bytes.hex(),
+                "call_module": "Registration",
+                "call_function": "register_node_with_hotkey",
+                "call_params": call_params,
+            }
+            console.print(json.dumps(payload, indent=2))
+            return 0
+
+        # Get keypair for signing
+        from hippius_sdk.config import get_seed_phrase
+        seed_phrase = get_seed_phrase()
+        if not seed_phrase:
+            error("No seed phrase available for signing transaction")
+            return 1
+
+        kp = Keypair.create_from_uri(seed_phrase)
+
+        # Submit transaction
+        log("Submitting registration transaction...")
+        call = substrate.compose_call(
+            call_module="Registration",
+            call_function="register_node_with_hotkey",
+            call_params=call_params,
+        )
+        extrinsic = substrate.create_signed_extrinsic(call=call, keypair=kp)
+        receipt = substrate.submit_extrinsic(extrinsic, wait_for_inclusion=True)
+
+        result = {
+            "extrinsic_hash": receipt.extrinsic_hash,
+            "is_success": receipt.is_success,
+            "error_message": receipt.error_message,
+            "triggered_events": [str(event) for event in receipt.triggered_events],
+        }
+
+        if receipt.is_success:
+            success(f"Node registered successfully with hotkey!")
+            success(f"Transaction hash: {receipt.extrinsic_hash}")
+        else:
+            error(f"Registration failed: {receipt.error_message}")
+
+        log("Full result:")
+        console.print(json.dumps(result, indent=2))
+
+        return 0 if receipt.is_success else 1
+
+    except Exception as e:
+        error(f"Error registering node with hotkey: {e}")
+        if hasattr(e, "__traceback__"):
+            import traceback
+
+            traceback.print_exc()
+        return 1

hippius_sdk/cli_parser.py

@@ -171,6 +171,7 @@ examples:
     add_seed_commands(subparsers)
     add_account_commands(subparsers)
     add_address_commands(subparsers)
+    add_miner_commands(subparsers)
 
     return parser
 
@@ -654,6 +655,152 @@ def add_address_commands(subparsers):
     )
 
 
+def add_miner_commands(subparsers):
+    """Add miner registration commands to the parser."""
+    # Miner command
+    miner_parser = subparsers.add_parser(
+        "miner", help="Miner node registration commands"
+    )
+    miner_subparsers = miner_parser.add_subparsers(
+        dest="miner_action", help="Miner action"
+    )
+
+    # Register coldkey command
+    register_coldkey_parser = miner_subparsers.add_parser(
+        "register-coldkey",
+        help="Register a node with coldkey (current account becomes coldkey)",
+    )
+
+    # Required arguments for register-coldkey
+    register_coldkey_parser.add_argument(
+        "--node-id", required=True, help="Your main node_id (libp2p peer ID)"
+    )
+    register_coldkey_parser.add_argument(
+        "--node-priv-hex",
+        required=True,
+        help="Main libp2p ed25519 private key hex (32/64B)",
+    )
+    register_coldkey_parser.add_argument(
+        "--node-type",
+        required=True,
+        choices=["StorageMiner", "Validator", "ComputeMiner", "StorageS3", "GpuMiner"],
+        help="Type of miner node",
+    )
+
+    # IPFS configuration (one required)
+    ipfs_group = register_coldkey_parser.add_mutually_exclusive_group(required=True)
+    ipfs_group.add_argument(
+        "--ipfs-config", help="Path to IPFS config file (e.g. ~/.ipfs/config)"
+    )
+    ipfs_group.add_argument(
+        "--ipfs-priv-b64",
+        help="IPFS Identity.PrivKey base64 if not using --ipfs-config",
+    )
+
+    # Optional arguments
+    register_coldkey_parser.add_argument(
+        "--ipfs-peer-id", help="Optional override IPFS PeerID"
+    )
+    register_coldkey_parser.add_argument(
+        "--pay-in-credits", action="store_true", help="Pay in credits for registration"
+    )
+    register_coldkey_parser.add_argument(
+        "--expires-in",
+        type=int,
+        default=10,
+        help="Challenge expiration in blocks (default: 10)",
+    )
+    register_coldkey_parser.add_argument(
+        "--block-width",
+        choices=["u32", "u64"],
+        default="u32",
+        help="Block number width (default: u32)",
+    )
+    register_coldkey_parser.add_argument(
+        "--domain",
+        default="HIPPIUS::REGISTER::v1",
+        help="Domain for challenge (default: HIPPIUS::REGISTER::v1)",
+    )
+    register_coldkey_parser.add_argument(
+        "--nonce-hex", help="32-byte hex nonce (optional, random if not provided)"
+    )
+    register_coldkey_parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Do not submit extrinsic; just print payload",
+    )
+
+    # Register hotkey command
+    register_hotkey_parser = miner_subparsers.add_parser(
+        "register-hotkey",
+        help="Register a node with hotkey (current account becomes hotkey)",
+    )
+
+    # Required arguments for register-hotkey
+    register_hotkey_parser.add_argument(
+        "--coldkey", required=True, help="Coldkey SS58 address"
+    )
+    register_hotkey_parser.add_argument(
+        "--node-id", required=True, help="Your main node_id (libp2p peer ID)"
+    )
+    register_hotkey_parser.add_argument(
+        "--node-priv-hex",
+        required=True,
+        help="Main libp2p ed25519 private key hex (32/64B)",
+    )
+    register_hotkey_parser.add_argument(
+        "--node-type",
+        required=True,
+        choices=["StorageMiner", "Validator", "ComputeMiner", "StorageS3", "GpuMiner"],
+        help="Type of miner node",
+    )
+
+    # IPFS configuration (one required)
+    ipfs_group_hotkey = register_hotkey_parser.add_mutually_exclusive_group(
+        required=True
+    )
+    ipfs_group_hotkey.add_argument(
+        "--ipfs-config", help="Path to IPFS config file (e.g. ~/.ipfs/config)"
+    )
+    ipfs_group_hotkey.add_argument(
+        "--ipfs-priv-b64",
+        help="IPFS Identity.PrivKey base64 if not using --ipfs-config",
+    )
+
+    # Optional arguments
+    register_hotkey_parser.add_argument(
+        "--ipfs-peer-id", help="Optional override IPFS PeerID"
+    )
+    register_hotkey_parser.add_argument(
+        "--pay-in-credits", action="store_true", help="Pay in credits for registration"
+    )
+    register_hotkey_parser.add_argument(
+        "--expires-in",
+        type=int,
+        default=10,
+        help="Challenge expiration in blocks (default: 10)",
+    )
+    register_hotkey_parser.add_argument(
+        "--block-width",
+        choices=["u32", "u64"],
+        default="u32",
+        help="Block number width (default: u32)",
+    )
+    register_hotkey_parser.add_argument(
+        "--domain",
+        default="HIPPIUS::REGISTER::v1",
+        help="Domain for challenge (default: HIPPIUS::REGISTER::v1)",
+    )
+    register_hotkey_parser.add_argument(
+        "--nonce-hex", help="32-byte hex nonce (optional, random if not provided)"
+    )
+    register_hotkey_parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Do not submit extrinsic; just print payload",
+    )
+
+
 def get_subparser(command: str) -> argparse.ArgumentParser:
     """Get a subparser for a specific command.
 

hippius_sdk/incentives.py

@@ -0,0 +1,487 @@
+#!/usr/bin/env python3
+import argparse
+import json
+import os
+import base64
+import secrets
+from typing import Tuple
+from nacl.signing import SigningKey
+from binascii import unhexlify, hexlify
+from hashlib import blake2b
+import base58
+
+from substrateinterface import SubstrateInterface, Keypair
+from scalecodec.utils.ss58 import ss58_decode
+
+
+# ---------- Helpers ----------
+def blake2_256(b: bytes) -> bytes:
+    return blake2b(b, digest_size=32).digest()
+
+
+def _read_varint(b: bytes, i: int) -> Tuple[int, int]:
+    x, s = 0, 0
+    while True:
+        if i >= len(b):
+            raise ValueError("truncated varint")
+        c = b[i]
+        i += 1
+        x |= (c & 0x7F) << s
+        if not (c & 0x80):
+            return x, i
+        s += 7
+
+
+def decode_libp2p_privkey_b64(privkey_b64: str) -> bytes:
+    """Decode go-libp2p PrivateKey proto; return ed25519 32B seed."""
+    raw = base64.b64decode(privkey_b64)
+    i = 0
+    key_type = None
+    data = None
+    while i < len(raw):
+        key, i = _read_varint(raw, i)
+        fld, wtype = key >> 3, key & 0x7
+        if fld == 1:
+            if wtype != 0:
+                raise ValueError("bad wiretype for Type")
+            key_type, i = _read_varint(raw, i)
+        elif fld == 2:
+            if wtype != 2:
+                raise ValueError("bad wiretype for Data")
+            ln, j = _read_varint(raw, i)
+            data = raw[j : j + ln]
+            i = j + ln
+        else:
+            if wtype == 0:
+                _, i = _read_varint(raw, i)
+            elif wtype == 2:
+                ln, j = _read_varint(raw, i)
+                i = j + ln
+            else:
+                raise ValueError("unsupported wiretype")
+    if key_type != 1:  # 1 = Ed25519
+        raise ValueError(f"Only Ed25519 supported (KeyType={key_type})")
+    if data is None:
+        raise ValueError("no Data")
+    if len(data) == 64:
+        return data[:32]
+    if len(data) == 32:
+        return data
+    raise ValueError(f"unexpected ed25519 Data length {len(data)}")
+
+
+def get_peer_id_from_public_key(public_key: bytes) -> str:
+    """Convert a public key to a libp2p peer ID"""
+    prefix = bytes([0x00, 0x24, 0x08, 0x01, 0x12, 0x20])
+    peer_id_bytes = prefix + public_key
+    return base58.b58encode(peer_id_bytes).decode()
+
+
+def get_public_key_from_peer_id(peer_id: str) -> bytes:
+    """Extract public key from a libp2p peer ID"""
+    peer_id_bytes = base58.b58decode(peer_id)
+
+    if len(peer_id_bytes) != 38:
+        raise ValueError(f"Invalid peer ID length: {len(peer_id_bytes)}")
+
+    prefix = bytes([0x00, 0x24, 0x08, 0x01, 0x12, 0x20])
+    if peer_id_bytes[:6] != prefix:
+        raise ValueError("Invalid peer ID prefix")
+
+    return peer_id_bytes[6:38]
+
+
+def load_ipfs_seed(
+    ipfs_config: str = None, ipfs_priv_b64: str = None
+) -> Tuple[bytes, str]:
+    if ipfs_priv_b64:
+        try:
+            seed = decode_libp2p_privkey_b64(ipfs_priv_b64)
+            return seed, ""
+        except ValueError as e:
+            raise SystemExit(f"Error decoding IPFS private key: {e}")
+
+    if not ipfs_config:
+        raise SystemExit(
+            "Either --ipfs-config or --ipfs-priv-b64 is required for IPFS setup."
+        )
+
+    cfg_path = os.path.expanduser(ipfs_config)
+    if not os.path.exists(cfg_path):
+        raise SystemExit(f"IPFS config file not found at {cfg_path}")
+
+    try:
+        cfg = json.load(open(cfg_path))
+    except json.JSONDecodeError:
+        raise SystemExit(f"Invalid JSON in IPFS config file: {cfg_path}")
+
+    ident = cfg.get("Identity") or {}
+    if "PrivKey" not in ident:
+        raise SystemExit("IPFS config missing Identity.PrivKey")
+
+    seed = decode_libp2p_privkey_b64(ident["PrivKey"])
+    return seed, ident.get("PeerID", "")
+
+
+def load_main_seed(node_priv_hex: str) -> bytes:
+    h = node_priv_hex.removeprefix("0x")
+    try:
+        b = unhexlify(h)
+    except Exception:
+        raise SystemExit("Invalid hex for node_priv_hex")
+    if len(b) == 32:
+        return b
+    if len(b) == 64:
+        return b[:32]
+    raise SystemExit("node_priv_hex must be 32 or 64 bytes")
+
+
+def encode_account_id(ss58_address: str) -> bytes:
+    """Convert SS58 address to 32-byte public key (AccountId)"""
+    decoded = ss58_decode(ss58_address)
+    if isinstance(decoded, str):
+        decoded = bytes.fromhex(decoded)
+    elif isinstance(decoded, list):
+        decoded = bytes(decoded)
+    if len(decoded) != 32:
+        raise ValueError(f"Decoded AccountId must be 32 bytes, got {len(decoded)}")
+    return decoded
+
+
+def verify_peer_id(public_key: bytes, peer_id: bytes, key_type: str) -> bool:
+    """Verify that a public key corresponds to a libp2p peer ID"""
+    if key_type != "Ed25519":
+        return False
+
+    if len(peer_id) != 38:
+        return False
+
+    expected_prefix = bytes([0x00, 0x24, 0x08, 0x01, 0x12, 0x20])
+    if peer_id[:6] != expected_prefix:
+        return False
+
+    return peer_id[6:38] == public_key
+
+
+def manual_encode_challenge(challenge_data, block_width):
+    """Manually encode the challenge data using basic Scale encoding"""
+    encoded = b""
+
+    encoded += challenge_data["domain"]
+    encoded += challenge_data["genesis_hash"]
+    encoded += challenge_data["account"]
+    encoded += challenge_data["node_id_hash"]
+    encoded += challenge_data["ipfs_peer_id_hash"]
+
+    if block_width == "u32":
+        encoded += challenge_data["block_number"].to_bytes(4, "little")
+    else:
+        encoded += challenge_data["block_number"].to_bytes(8, "little")
+
+    encoded += challenge_data["nonce"]
+
+    if block_width == "u32":
+        encoded += challenge_data["expires_at"].to_bytes(4, "little")
+    else:
+        encoded += challenge_data["expires_at"].to_bytes(8, "little")
+
+    return encoded
+
+
+# ---------- CLI ----------
+
+
+def main():
+    ap = argparse.ArgumentParser(
+        description="Hippius v2 register: dual libp2p sigs + one-shot challenge"
+    )
+    ap.add_argument(
+        "--ws", required=True, help="Substrate WS endpoint (e.g. ws://127.0.0.1:9944)"
+    )
+    ap.add_argument("--module", default="Registration", help="Pallet name in metadata")
+    ap.add_argument(
+        "--function",
+        default="register_node_with_coldkey",
+        choices=[
+            "register_node_with_coldkey",
+            "register_node_with_hotkey",
+            "verify_existing_node",
+            "verify_existing_coldkey_node",
+        ],
+        help="Call function",
+    )
+
+    ap.add_argument(
+        "--owner-uri", required=True, help="Owner secret URI //path or mnemonic"
+    )
+    ap.add_argument("--owner-ss58", required=True, help="Owner SS58 address")
+    ap.add_argument("--owner-crypto", choices=["sr25519", "ed25519"], default="sr25519")
+
+    ap.add_argument("--node-id", required=True, help="Your main node_id (hex or utf8)")
+    ap.add_argument(
+        "--node-priv-hex",
+        required=True,
+        help="Main libp2p ed25519 private key hex (32/64B)",
+    )
+
+    ap.add_argument("--ipfs-config", help="~/.ipfs/config (reads PeerID & PrivKey)")
+    ap.add_argument(
+        "--ipfs-priv-b64", help="Identity.PrivKey base64 if not using --ipfs-config"
+    )
+    ap.add_argument("--ipfs-peer-id", help="Optional override PeerID (utf8)")
+    ap.add_argument("--expires-in", type=int, default=10)
+    ap.add_argument("--block-width", choices=["u32", "u64"], default="u32")
+    ap.add_argument("--domain", default="HIPPIUS::REGISTER::v1")
+    ap.add_argument("--nonce-hex", help="32-byte hex (optional)")
+    ap.add_argument(
+        "--node-type",
+        choices=["StorageMiner", "Validator", "ComputeMiner", "StorageS3", "GpuMiner"],
+        help="Required for registration functions",
+    )
+    ap.add_argument(
+        "--pay-in-credits", action="store_true", help="Pay in credits for registration"
+    )
+
+    ap.add_argument(
+        "--coldkey",
+        help="Coldkey SS58 address (required for register_node_with_hotkey)",
+    )
+
+    ap.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Do not submit extrinsic; just print payload",
+    )
+    args = ap.parse_args()
+
+    # Validate function-specific requirements
+    if args.function == "register_node_with_hotkey" and not args.coldkey:
+        raise SystemExit("--coldkey is required for register_node_with_hotkey function")
+    if (
+        args.function in ["register_node_with_coldkey", "register_node_with_hotkey"]
+        and not args.node_type
+    ):
+        raise SystemExit("--node-type is required for registration functions")
+
+    # Initialize SubstrateInterface
+    substrate = SubstrateInterface(url=args.ws)
+
+    # Connect & fetch genesis hash
+    genesis_hash_hex = substrate.get_block_hash(0)
+    genesis_hash = bytes.fromhex(genesis_hash_hex[2:])
+
+    # Get current block number from chain
+    try:
+        current_block_number = substrate.get_block_number(None)
+        print(f"Current block number: {current_block_number}")
+    except Exception as e:
+        raise SystemExit(f"Error fetching current block number: {e}")
+
+    # Ensure node_id_bytes is correctly formed
+    if args.node_id.startswith("0x"):
+        node_id_bytes = bytes.fromhex(args.node_id[2:])
+    else:
+        node_id_bytes = base58.b58decode(args.node_id)
+
+    ipfs_seed, peerid_from_config = load_ipfs_seed(args.ipfs_config, args.ipfs_priv_b64)
+    if args.ipfs_peer_id:
+        ipfs_peer_id_bytes = base58.b58decode(args.ipfs_peer_id)
+    elif peerid_from_config:
+        ipfs_peer_id_bytes = base58.b58decode(peerid_from_config)
+    else:
+        if args.node_type in ["StorageMiner", "Validator"] and args.function in [
+            "register_node_with_coldkey",
+            "register_node_with_hotkey",
+        ]:
+            raise SystemExit(
+                "IPFS PeerID is required for StorageMiner and Validator node WARRANTtypes."
+            )
+        ipfs_peer_id_bytes = b""
+
+    main_seed = load_main_seed(args.node_priv_hex)
+
+    # Keys & pubkeys
+    main_sk = SigningKey(main_seed)
+    main_pk = bytes(main_sk.verify_key)
+    ipfs_sk = SigningKey(ipfs_seed)
+    ipfs_pk = bytes(ipfs_sk.verify_key)
+
+    # DEBUG: Print what we're working with
+    print(f"Main public key: 0x{main_pk.hex()}")
+    print(f"IPFS public key: 0x{ipfs_pk.hex()}")
+
+    expected_main_peer_id = get_peer_id_from_public_key(main_pk)
+    expected_ipfs_peer_id = get_peer_id_from_public_key(ipfs_pk)
+    print(f"Expected main node ID from private key: {expected_main_peer_id}")
+    print(f"Expected IPFS peer ID from private key: {expected_ipfs_peer_id}")
+    print(f"Provided main node ID: {args.node_id}")
+    print(
+        f"Provided IPFS peer ID: {args.ipfs_peer_id if args.ipfs_peer_id else peerid_from_config}"
+    )
+
+    try:
+        expected_main_pk = get_public_key_from_peer_id(args.node_id)
+        print(f"Expected main public key from node ID: 0x{expected_main_pk.hex()}")
+    except Exception as e:
+        print(f"Error extracting public key from main node ID: {e}")
+
+    try:
+        provided_ipfs_peer_id = (
+            args.ipfs_peer_id if args.ipfs_peer_id else peerid_from_config
+        )
+        expected_ipfs_pk = get_public_key_from_peer_id(provided_ipfs_peer_id)
+        print(f"Expected IPFS public key from peer ID: 0x{expected_ipfs_pk.hex()}")
+    except Exception as e:
+        print(f"Error extracting public key from IPFS peer ID: {e}")
+
+    if not verify_peer_id(main_pk, node_id_bytes, "Ed25519"):
+        raise SystemExit("Main public key does not match node ID")
+
+    if ipfs_peer_id_bytes and not verify_peer_id(
+        ipfs_pk, ipfs_peer_id_bytes, "Ed25519"
+    ):
+        raise SystemExit("IPFS public key does not match peer ID")
+
+    # Challenge bytes
+    domain = args.domain.encode()
+    domain24 = b"HIPPIUS::REGISTER::v1" + b"\x00" * 3
+
+    node_id_hash = blake2_256(node_id_bytes)
+    ipfs_peer_id_hash = blake2_256(ipfs_peer_id_bytes)
+
+    nonce = (
+        bytes.fromhex(args.nonce_hex[2:])
+        if args.nonce_hex and args.nonce_hex.startswith("0x")
+        else bytes.fromhex(args.nonce_hex)
+        if args.nonce_hex
+        else secrets.token_bytes(32)
+    )
+
+    expires_at_block = current_block_number + args.expires_in
+
+    account_bytes = encode_account_id(args.owner_ss58)
+
+    challenge_data = {
+        "domain": domain24,
+        "genesis_hash": genesis_hash,
+        "account": account_bytes,
+        "node_id_hash": node_id_hash,
+        "ipfs_peer_id_hash": ipfs_peer_id_hash,
+        "block_number": current_block_number,
+        "nonce": nonce,
+        "expires_at": expires_at_block,
+    }
+
+    try:
+        challenge_bytes = manual_encode_challenge(challenge_data, args.block_width)
+        print(f"Successfully encoded challenge bytes: 0x{challenge_bytes.hex()}")
+    except Exception as e:
+        print(f"Error encoding challenge bytes: {e}")
+        raise
+
+    main_sig = main_sk.sign(challenge_bytes).signature
+    ipfs_sig = ipfs_sk.sign(challenge_bytes).signature
+
+    # Compose call params based on function
+    if args.function == "register_node_with_coldkey":
+        call_params = {
+            "node_type": args.node_type,
+            "node_id": args.node_id,
+            "node_id_hex": "0x" + hexlify(node_id_bytes).decode(),
+            "pay_in_credits": bool(args.pay_in_credits),
+            "ipfs_node_id": args.ipfs_peer_id,
+            "owner": args.owner_ss58,
+            "ipfs_peer_id": args.ipfs_peer_id,
+            "ipfs_id_hex": "0x" + hexlify(ipfs_peer_id_bytes).decode(),
+            "main_key_type": "Ed25519",
+            "main_public_key": "0x" + main_pk.hex(),
+            "main_sig": "0x" + main_sig.hex(),
+            "ipfs_key_type": "Ed25519",
+            "ipfs_public_key": "0x" + ipfs_pk.hex(),
+            "ipfs_sig": "0x" + ipfs_sig.hex(),
+            "challenge_bytes": "0x" + challenge_bytes.hex(),
+        }
+    elif args.function == "register_node_with_hotkey":
+        call_params = {
+            "coldkey": args.coldkey,
+            "node_type": args.node_type,
+            "node_id": args.node_id,
+            "node_id_hex": "0x" + hexlify(node_id_bytes).decode(),
+            "pay_in_credits": bool(args.pay_in_credits),
+            "ipfs_node_id": args.ipfs_peer_id,
+            "ipfs_peer_id": args.ipfs_peer_id,
+            "ipfs_id_hex": "0x" + hexlify(ipfs_peer_id_bytes).decode(),
+            "owner": args.owner_ss58,
+            "main_key_type": "Ed25519",
+            "main_public_key": "0x" + main_pk.hex(),
+            "main_sig": "0x" + main_sig.hex(),
+            "ipfs_key_type": "Ed25519",
+            "ipfs_public_key": "0x" + ipfs_pk.hex(),
+            "ipfs_sig": "0x" + ipfs_sig.hex(),
+            "challenge_bytes": "0x" + challenge_bytes.hex(),
+        }
+    elif args.function in ["verify_existing_node", "verify_existing_coldkey_node"]:
+        call_params = {
+            "node_id": args.node_id,
+            "node_id_hex": "0x" + hexlify(node_id_bytes).decode(),
+            "ipfs_id_hex": "0x" + hexlify(ipfs_peer_id_bytes).decode(),
+            "main_key_type": "Ed25519",
+            "main_public_key": "0x" + main_pk.hex(),
+            "main_sig": "0x" + main_sig.hex(),
+            "ipfs_key_type": "Ed25519",
+            "ipfs_public_key": "0x" + ipfs_pk.hex(),
+            "ipfs_sig": "0x" + ipfs_sig.hex(),
+            "challenge_bytes": "0x" + challenge_bytes.hex(),
+        }
+
+    if args.dry_run:
+        print(
+            json.dumps(
+                {
+                    "genesis_hash_hex": "0x" + genesis_hash.hex(),
+                    "current_block_number": current_block_number,
+                    "challenge_bytes_hex": "0x" + challenge_bytes.hex(),
+                    "call_module": args.module,
+                    "call_function": args.function,
+                    "call_params": call_params,
+                },
+                indent=2,
+            )
+        )
+        return
+
+    try:
+        from substrateinterface import KeypairType
+
+        crypto_arg = (
+            KeypairType.SR25519
+            if args.owner_crypto == "sr25519"
+            else KeypairType.ED25519
+        )
+        kp = Keypair.create_from_uri(args.owner_uri, crypto_type=crypto_arg)
+    except Exception as e:
+        print(
+            f"Error creating keypair with specified type: {e}. Falling back to default sr25519."
+        )
+        kp = Keypair.create_from_uri(args.owner_uri)
+
+    call = substrate.compose_call(
+        call_module=args.module, call_function=args.function, call_params=call_params
+    )
+    extrinsic = substrate.create_signed_extrinsic(call=call, keypair=kp)
+    receipt = substrate.submit_extrinsic(extrinsic, wait_for_inclusion=True)
+    print(
+        json.dumps(
+            {
+                "extrinsic_hash": receipt.extrinsic_hash,
+                "is_success": receipt.is_success,
+                "error_message": receipt.error_message,
+                "triggered_events": [str(event) for event in receipt.triggered_events],
+            },
+            indent=2,
+        )
+    )
+
+
+if __name__ == "__main__":
+    main()