hippius 0.1.9__py3-none-any.whl → 0.1.10__py3-none-any.whl

{hippius-0.1.9.dist-info → hippius-0.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hippius
-Version: 0.1.9
+Version: 0.1.10
 Summary: Python SDK and CLI for Hippius blockchain storage
 Home-page: https://github.com/thenervelab/hippius-sdk
 Author: Dubs
@@ -943,3 +943,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.10.dist-info/RECORD

@@ -0,0 +1,12 @@
+hippius_sdk/__init__.py,sha256=OluIKx43ZOGvMI0W06B4bTTcmOJz4e6lq46GLBbPg8M,1402
+hippius_sdk/account.py,sha256=R0lsyUAqe4nmPyiMt4hGDRucoSrpeLouWBVe7DP20Bc,24308
+hippius_sdk/cli.py,sha256=ZHYw4-sUTT8wf_hlOIE1C9TLFOe6aGcLIB8bvC6UMOE,84047
+hippius_sdk/client.py,sha256=54tsg4k29sqt3F77LQJ_vhzzTR73QuZ_edqI_BvZM1E,14905
+hippius_sdk/config.py,sha256=wrVU0599aH39NIVRL59pZPyHXRevATQR9zwIUkCaWFE,25389
+hippius_sdk/ipfs.py,sha256=9fds5MJwVb7t8IqROM70x9fWgyk9_Ot5psat_hMnRN8,63969
+hippius_sdk/substrate.py,sha256=V49s1VYbl94Wk8-IH8DQsXLmRsAShGhIX9aYSY0BkBk,33034
+hippius_sdk/utils.py,sha256=FSdVhYuCsKRNZiN9-XdzN2HESHXAVcWEpOpb3CLmVPI,2192
+hippius-0.1.10.dist-info/METADATA,sha256=9s1i1aXU-lhxzGeuvjk4cDHoFkbVcbFNOSJPg4r8Evg,31298
+hippius-0.1.10.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+hippius-0.1.10.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
+hippius-0.1.10.dist-info/RECORD,,

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",