hippius 0.1.9__tar.gz → 0.1.11__tar.gz

{hippius-0.1.9 → hippius-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hippius
-Version: 0.1.9
+Version: 0.1.11
 Summary: Python SDK and CLI for Hippius blockchain storage
 Home-page: https://github.com/thenervelab/hippius-sdk
 Author: Dubs
@@ -348,6 +348,18 @@ When choosing the second option, the system will process each file in the direct
 - Successfully coded files with their metadata CIDs
 - Any files that failed, with error details
 
+You can also directly use the dedicated command for directory erasure coding:
+
+```bash
+# Direct command for applying erasure coding to an entire directory
+hippius erasure-code-dir my_directory/
+
+# With custom parameters
+hippius erasure-code-dir my_important_files/ --k 4 --m 8 --encrypt
+```
+
+This dedicated command processes each file in the directory individually, optimizing erasure coding parameters for each file based on its size.
+
 To reconstruct a file from erasure-coded chunks:
 
 ```bash
@@ -943,3 +955,95 @@ client = HippiusClient(
 
 The multi-account system makes it easier to manage multiple identities while maintaining security and convenience.
 
+## Blockchain Account Management
+
+Hippius SDK provides a comprehensive solution for managing blockchain accounts, including coldkeys, hotkeys, and proxy relationships.
+
+### Coldkeys and Hotkeys
+
+Hippius uses a hierarchical account structure:
+
+- **Coldkey**: The main account that holds your funds and grants permissions
+- **Hotkey**: Delegated accounts that can perform specific actions on behalf of your coldkey
+
+This separation provides enhanced security by allowing you to keep your main account (coldkey) secure while using hotkeys for day-to-day operations.
+
+### Creating and Managing Accounts
+
+```python
+from hippius_sdk.account import AccountManager
+
+# Initialize the account manager
+account_manager = AccountManager()
+
+# Create a coldkey (main account)
+coldkey = account_manager.create_coldkey(
+    name="my_hippius_coldkey",  # Optional custom name
+    mnemonic="your mnemonic phrase here"  # Optional - will generate if not provided
+)
+
+# Create a hotkey associated with the coldkey
+hotkey = account_manager.create_hotkey(
+    name="my_hippius_hotkey_1",  # Optional custom name
+    coldkey_address=coldkey["address"]  # Optional association
+)
+
+# List all coldkeys
+coldkeys = account_manager.list_coldkeys()
+
+# List hotkeys for a specific coldkey
+hotkeys = account_manager.list_hotkeys(coldkey_address=coldkey["address"])
+
+# Create a proxy relationship on the blockchain
+result = account_manager.create_proxy_relationship(
+    coldkey_address=coldkey["address"],
+    hotkey_address=hotkey["address"],
+    proxy_type="NonTransfer",  # Type of permissions granted
+    delay=0  # Blocks before proxy becomes active
+)
+
+# List proxy relationships
+proxies = account_manager.list_proxies(coldkey_address=coldkey["address"])
+
+# Remove a proxy relationship
+result = account_manager.remove_proxy(
+    coldkey_address=coldkey["address"],
+    hotkey_address=hotkey["address"]
+)
+```
+
+### CLI Commands for Account Management
+
+The SDK provides CLI commands for managing accounts:
+
+```bash
+# Create a coldkey
+hippius account coldkey create --name "my_hippius_coldkey" --generate-mnemonic --show-mnemonic
+
+# Create a hotkey and associate with a coldkey
+hippius account hotkey create --name "my_hippius_hotkey_1" --coldkey [COLDKEY_ADDRESS]
+
+# List accounts
+hippius account list coldkey --verbose
+hippius account list hotkey
+hippius account list proxy --coldkey [COLDKEY_ADDRESS]
+
+# Create a proxy relationship on the blockchain
+hippius account proxy create --coldkey [COLDKEY_ADDRESS] --hotkey [HOTKEY_ADDRESS] --proxy-type NonTransfer
+
+# Remove a proxy relationship
+hippius account proxy remove --coldkey [COLDKEY_ADDRESS] --hotkey [HOTKEY_ADDRESS]
+```
+
+### Best Practices for Account Management
+
+1. **Security**: Keep your coldkey mnemonic secure and never share it. This is the master key to your account.
+
+2. **Proxy Types**: Different proxy types grant different permissions:
+   - `NonTransfer`: Can perform operations except transferring funds
+   - Other types may be available depending on the chain configuration
+
+3. **Multiple Hotkeys**: Create separate hotkeys for different applications or services to limit the impact if one is compromised.
+
+4. **Regular Auditing**: Regularly check your proxy relationships using `hippius account list proxy` to ensure only authorized delegates have access.
+

{hippius-0.1.9 → hippius-0.1.11}/README.md

@@ -317,6 +317,18 @@ When choosing the second option, the system will process each file in the direct
 - Successfully coded files with their metadata CIDs
 - Any files that failed, with error details
 
+You can also directly use the dedicated command for directory erasure coding:
+
+```bash
+# Direct command for applying erasure coding to an entire directory
+hippius erasure-code-dir my_directory/
+
+# With custom parameters
+hippius erasure-code-dir my_important_files/ --k 4 --m 8 --encrypt
+```
+
+This dedicated command processes each file in the directory individually, optimizing erasure coding parameters for each file based on its size.
+
 To reconstruct a file from erasure-coded chunks:
 
 ```bash
@@ -911,3 +923,95 @@ client = HippiusClient(
 ```
 
 The multi-account system makes it easier to manage multiple identities while maintaining security and convenience.
+
+## Blockchain Account Management
+
+Hippius SDK provides a comprehensive solution for managing blockchain accounts, including coldkeys, hotkeys, and proxy relationships.
+
+### Coldkeys and Hotkeys
+
+Hippius uses a hierarchical account structure:
+
+- **Coldkey**: The main account that holds your funds and grants permissions
+- **Hotkey**: Delegated accounts that can perform specific actions on behalf of your coldkey
+
+This separation provides enhanced security by allowing you to keep your main account (coldkey) secure while using hotkeys for day-to-day operations.
+
+### Creating and Managing Accounts
+
+```python
+from hippius_sdk.account import AccountManager
+
+# Initialize the account manager
+account_manager = AccountManager()
+
+# Create a coldkey (main account)
+coldkey = account_manager.create_coldkey(
+    name="my_hippius_coldkey",  # Optional custom name
+    mnemonic="your mnemonic phrase here"  # Optional - will generate if not provided
+)
+
+# Create a hotkey associated with the coldkey
+hotkey = account_manager.create_hotkey(
+    name="my_hippius_hotkey_1",  # Optional custom name
+    coldkey_address=coldkey["address"]  # Optional association
+)
+
+# List all coldkeys
+coldkeys = account_manager.list_coldkeys()
+
+# List hotkeys for a specific coldkey
+hotkeys = account_manager.list_hotkeys(coldkey_address=coldkey["address"])
+
+# Create a proxy relationship on the blockchain
+result = account_manager.create_proxy_relationship(
+    coldkey_address=coldkey["address"],
+    hotkey_address=hotkey["address"],
+    proxy_type="NonTransfer",  # Type of permissions granted
+    delay=0  # Blocks before proxy becomes active
+)
+
+# List proxy relationships
+proxies = account_manager.list_proxies(coldkey_address=coldkey["address"])
+
+# Remove a proxy relationship
+result = account_manager.remove_proxy(
+    coldkey_address=coldkey["address"],
+    hotkey_address=hotkey["address"]
+)
+```
+
+### CLI Commands for Account Management
+
+The SDK provides CLI commands for managing accounts:
+
+```bash
+# Create a coldkey
+hippius account coldkey create --name "my_hippius_coldkey" --generate-mnemonic --show-mnemonic
+
+# Create a hotkey and associate with a coldkey
+hippius account hotkey create --name "my_hippius_hotkey_1" --coldkey [COLDKEY_ADDRESS]
+
+# List accounts
+hippius account list coldkey --verbose
+hippius account list hotkey
+hippius account list proxy --coldkey [COLDKEY_ADDRESS]
+
+# Create a proxy relationship on the blockchain
+hippius account proxy create --coldkey [COLDKEY_ADDRESS] --hotkey [HOTKEY_ADDRESS] --proxy-type NonTransfer
+
+# Remove a proxy relationship
+hippius account proxy remove --coldkey [COLDKEY_ADDRESS] --hotkey [HOTKEY_ADDRESS]
+```
+
+### Best Practices for Account Management
+
+1. **Security**: Keep your coldkey mnemonic secure and never share it. This is the master key to your account.
+
+2. **Proxy Types**: Different proxy types grant different permissions:
+   - `NonTransfer`: Can perform operations except transferring funds
+   - Other types may be available depending on the chain configuration
+
+3. **Multiple Hotkeys**: Create separate hotkeys for different applications or services to limit the impact if one is compromised.
+
+4. **Regular Auditing**: Regularly check your proxy relationships using `hippius account list proxy` to ensure only authorized delegates have access.

{hippius-0.1.9 → hippius-0.1.11}/hippius_sdk/__init__.py

@@ -4,6 +4,8 @@ Hippius SDK - Python interface for Hippius blockchain storage
 
 from hippius_sdk.client import HippiusClient
 from hippius_sdk.ipfs import IPFSClient
+from hippius_sdk.substrate import SubstrateClient
+from hippius_sdk.account import AccountManager
 from hippius_sdk.config import (
     get_config_value,
     set_config_value,
@@ -29,6 +31,8 @@ __version__ = "0.1.0"
 __all__ = [
     "HippiusClient",
     "IPFSClient",
+    "SubstrateClient",
+    "AccountManager",
     "get_config_value",
     "set_config_value",
     "get_encryption_key",