cartha-cli 1.0.0__tar.gz → 1.0.2__tar.gz

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/CONTRIBUTING.md

@@ -16,22 +16,24 @@ Thank you for your interest in contributing to the Cartha CLI! This guide will h
 1. **Fork and clone the repository**
 
    ```bash
-   git clone https://github.com/your-username/cartha-cli.git
+   git clone https://github.com/General-Tao-Ventures/cartha-cli.git
    cd cartha-cli
    ```
 
-2. **Install dependencies**
+2. **Install dependencies for development**
 
    ```bash
+   # Using uv (recommended for development)
    uv sync
-   # or
-   pip install -e .
+   
+   # Or using pip in editable mode
+   pip install -e ".[dev]"
    ```
 
 3. **Run tests**
 
    ```bash
-   uv run pytest
+   pytest
    # or
    make test
    ```
@@ -63,11 +65,11 @@ git checkout -b fix/your-bug-fix
 
 ```bash
 # Run tests
-uv run pytest
+pytest
 
 # Test CLI commands locally
-uv run cartha --help
-uv run cartha pair status --help
+cartha --help
+cartha miner status --help
 ```
 
 ### 5. Commit Your Changes

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cartha-cli
-Version: 1.0.0
+Version: 1.0.2
 Summary: CLI utilities for Cartha subnet miners.
 Project-URL: Homepage, https://cartha.finance
 Project-URL: Repository, https://github.com/General-Tao-Ventures/cartha-cli
@@ -45,34 +45,36 @@ Cartha CLI makes mining on the Cartha subnet effortless. As the Liquidity Provid
 - **💼 Multi-Pool Management** - Track multiple trading pairs in one place
 - **🔑 Secure by Default** - Your password stays hidden until you actually need it
 
-## Quick Start
+## Installation
 
 ```bash
-# Install dependencies
-uv sync
+pip install cartha-cli
+```
+
+## Quick Start
 
+```bash
 # Show available commands
-uv run cartha
+cartha --help
 
 # Get started with registration
-uv run cartha miner register --help
+cartha miner register --help
 
 # Check your miner status (no authentication needed)
-uv run cartha miner status --help
+cartha miner status --help
 
 # Check CLI health and connectivity
-uv run cartha health
+cartha health
 
 # Or use short aliases
-uv run cartha m status
-uv run cartha v lock
+cartha m status
+cartha v lock
 ```
 
 ## Requirements
 
 - Python 3.11
 - Bittensor wallet
-- [`uv`](https://github.com/astral-sh/uv) package manager (or pip)
 
 ## What You Can Do
 

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/README.md

@@ -12,34 +12,36 @@ Cartha CLI makes mining on the Cartha subnet effortless. As the Liquidity Provid
 - **💼 Multi-Pool Management** - Track multiple trading pairs in one place
 - **🔑 Secure by Default** - Your password stays hidden until you actually need it
 
-## Quick Start
+## Installation
 
 ```bash
-# Install dependencies
-uv sync
+pip install cartha-cli
+```
+
+## Quick Start
 
+```bash
 # Show available commands
-uv run cartha
+cartha --help
 
 # Get started with registration
-uv run cartha miner register --help
+cartha miner register --help
 
 # Check your miner status (no authentication needed)
-uv run cartha miner status --help
+cartha miner status --help
 
 # Check CLI health and connectivity
-uv run cartha health
+cartha health
 
 # Or use short aliases
-uv run cartha m status
-uv run cartha v lock
+cartha m status
+cartha v lock
 ```
 
 ## Requirements
 
 - Python 3.11
 - Bittensor wallet
-- [`uv`](https://github.com/astral-sh/uv) package manager (or pip)
 
 ## What You Can Do
 

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/cartha_cli/commands/pair_status.py

@@ -35,21 +35,25 @@ from .shared_options import (
 )
 
 # Import pool name helper
+# Initialize fallback function first to ensure it's always defined
+def _fallback_pool_id_to_name(pool_id: str) -> str | None:
+    """Simple fallback to decode pool ID."""
+    try:
+        hex_str = pool_id.lower().removeprefix("0x")
+        pool_bytes = bytes.fromhex(hex_str)
+        name = pool_bytes.rstrip(b"\x00").decode("utf-8", errors="ignore")
+        if name and name.isprintable():
+            return name
+    except Exception:
+        pass
+    return None
+
+# Try to import from testnet module, fallback to default if not available
 try:
     from ...testnet.pool_ids import pool_id_to_name
-except ImportError:
-    # Fallback if running from different context
-    def pool_id_to_name(pool_id: str) -> str | None:
-        """Simple fallback to decode pool ID."""
-        try:
-            hex_str = pool_id.lower().removeprefix("0x")
-            pool_bytes = bytes.fromhex(hex_str)
-            name = pool_bytes.rstrip(b"\x00").decode("utf-8", errors="ignore")
-            if name and name.isprintable():
-                return name
-        except Exception:
-            pass
-        return None
+except (ImportError, ModuleNotFoundError):
+    # Use fallback function
+    pool_id_to_name = _fallback_pool_id_to_name
 
 
 def pair_status(

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/cartha_cli/commands/pools.py

@@ -7,13 +7,27 @@ import typer
 from .common import console
 
 # Import pool helpers for pool_id conversion
+# Initialize fallback functions first to ensure they're always defined
+def _fallback_list_pools() -> dict[str, str]:
+    """Fallback: return empty dict."""
+    return {}
+
+def _fallback_pool_id_to_vault_address(pool_id: str) -> str | None:
+    """Fallback: return None."""
+    return None
+
+def _fallback_pool_id_to_chain_id(pool_id: str) -> int | None:
+    """Fallback: return None."""
+    return None
+
+# Try to import from testnet module, fallback to defaults if not available
 try:
     from ...testnet.pool_ids import (
         list_pools,
         pool_id_to_chain_id,
         pool_id_to_vault_address,
     )
-except ImportError:
+except (ImportError, ModuleNotFoundError):
     # Fallback if running from different context
     import sys
     from pathlib import Path
@@ -28,19 +42,16 @@ except ImportError:
                 pool_id_to_chain_id,
                 pool_id_to_vault_address,
             )
-        except ImportError:
-            # Final fallback
-            def list_pools() -> dict[str, str]:
-                """Fallback: return empty dict."""
-                return {}
-
-            def pool_id_to_vault_address(pool_id: str) -> str | None:
-                """Fallback: return None."""
-                return None
-
-            def pool_id_to_chain_id(pool_id: str) -> int | None:
-                """Fallback: return None."""
-                return None
+        except (ImportError, ModuleNotFoundError):
+            # Use fallback functions
+            list_pools = _fallback_list_pools
+            pool_id_to_vault_address = _fallback_pool_id_to_vault_address
+            pool_id_to_chain_id = _fallback_pool_id_to_chain_id
+    else:
+        # Use fallback functions if testnet directory doesn't exist
+        list_pools = _fallback_list_pools
+        pool_id_to_vault_address = _fallback_pool_id_to_vault_address
+        pool_id_to_chain_id = _fallback_pool_id_to_chain_id
 
 
 def pools(

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/cartha_cli/commands/prove_lock.py

@@ -43,6 +43,48 @@ from .shared_options import (
 )
 
 # Import pool helpers for pool_id conversion
+# Initialize fallback functions first to ensure they're always defined
+def _fallback_pool_name_to_id(pool_name: str) -> str:
+    """Fallback: encode pool name as hex."""
+    name_bytes = pool_name.encode("utf-8")
+    padded = name_bytes.ljust(32, b"\x00")
+    return "0x" + padded.hex()
+
+def _fallback_pool_id_to_name(pool_id: str) -> str | None:
+    """Fallback: try to decode."""
+    try:
+        hex_str = pool_id.lower().removeprefix("0x")
+        pool_bytes = bytes.fromhex(hex_str)
+        name = pool_bytes.rstrip(b"\x00").decode("utf-8", errors="ignore")
+        return name if name and name.isprintable() else None
+    except Exception:
+        return None
+
+def _fallback_format_pool_id(pool_id: str) -> str:
+    """Fallback: return pool_id as-is."""
+    return pool_id
+
+def _fallback_list_pools() -> dict[str, str]:
+    """Fallback: return empty dict."""
+    return {}
+
+def _fallback_pool_id_to_vault_address(pool_id: str) -> str | None:
+    """Fallback: return None."""
+    return None
+
+def _fallback_vault_address_to_pool_id(vault_address: str) -> str | None:
+    """Fallback: return None."""
+    return None
+
+def _fallback_pool_id_to_chain_id(pool_id: str) -> int | None:
+    """Fallback: return None."""
+    return None
+
+def _fallback_vault_address_to_chain_id(vault_address: str) -> int | None:
+    """Fallback: return None."""
+    return None
+
+# Try to import from testnet module, fallback to defaults if not available
 try:
     from ...testnet.pool_ids import (
         format_pool_id,
@@ -54,7 +96,7 @@ try:
         vault_address_to_chain_id,
         vault_address_to_pool_id,
     )
-except ImportError:
+except (ImportError, ModuleNotFoundError):
     # Fallback if running from different context
     import sys
     from pathlib import Path
@@ -74,47 +116,26 @@ except ImportError:
                 vault_address_to_chain_id,
                 vault_address_to_pool_id,
             )
-        except ImportError:
-            # Final fallback
-            def pool_name_to_id(pool_name: str) -> str:
-                """Fallback: encode pool name as hex."""
-                name_bytes = pool_name.encode("utf-8")
-                padded = name_bytes.ljust(32, b"\x00")
-                return "0x" + padded.hex()
-            
-            def pool_id_to_name(pool_id: str) -> str | None:
-                """Fallback: try to decode."""
-                try:
-                    hex_str = pool_id.lower().removeprefix("0x")
-                    pool_bytes = bytes.fromhex(hex_str)
-                    name = pool_bytes.rstrip(b"\x00").decode("utf-8", errors="ignore")
-                    return name if name and name.isprintable() else None
-                except Exception:
-                    return None
-            
-            def format_pool_id(pool_id: str) -> str:
-                """Fallback: return pool_id as-is."""
-                return pool_id
-            
-            def list_pools() -> dict[str, str]:
-                """Fallback: return empty dict."""
-                return {}
-            
-            def pool_id_to_vault_address(pool_id: str) -> str | None:
-                """Fallback: return None."""
-                return None
-            
-            def vault_address_to_pool_id(vault_address: str) -> str | None:
-                """Fallback: return None."""
-                return None
-            
-            def pool_id_to_chain_id(pool_id: str) -> int | None:
-                """Fallback: return None."""
-                return None
-            
-            def vault_address_to_chain_id(vault_address: str) -> int | None:
-                """Fallback: return None."""
-                return None
+        except (ImportError, ModuleNotFoundError):
+            # Use fallback functions
+            pool_name_to_id = _fallback_pool_name_to_id
+            pool_id_to_name = _fallback_pool_id_to_name
+            format_pool_id = _fallback_format_pool_id
+            list_pools = _fallback_list_pools
+            pool_id_to_vault_address = _fallback_pool_id_to_vault_address
+            vault_address_to_pool_id = _fallback_vault_address_to_pool_id
+            pool_id_to_chain_id = _fallback_pool_id_to_chain_id
+            vault_address_to_chain_id = _fallback_vault_address_to_chain_id
+    else:
+        # Use fallback functions if testnet directory doesn't exist
+        pool_name_to_id = _fallback_pool_name_to_id
+        pool_id_to_name = _fallback_pool_id_to_name
+        format_pool_id = _fallback_format_pool_id
+        list_pools = _fallback_list_pools
+        pool_id_to_vault_address = _fallback_pool_id_to_vault_address
+        vault_address_to_pool_id = _fallback_vault_address_to_pool_id
+        pool_id_to_chain_id = _fallback_pool_id_to_chain_id
+        vault_address_to_chain_id = _fallback_vault_address_to_chain_id
 
 
 def prove_lock(
@@ -639,8 +660,8 @@ def prove_lock(
             "• Liquidation events may result in partial loss of capital\n"
             "• Lost funds are NOT reimbursed - this is the LP risk model\n"
             "• You earn subnet rewards + liquidation fees in return\n"
-            "• Minimum collateral: 100k USDC to maintain full emission scoring\n"
-            "• If your withdrawable balance falls below 100k USDC, your emission scoring will be reduced\n\n"
+            "• Minimum collateral: 100k USDC total across all your positions to maintain full emission scoring\n"
+            "• If your total withdrawable balance across all positions falls below 100k USDC, your emission scoring will be reduced\n\n"
             "[bold red]Only commit funds you can afford to lose.[/]\n\n"
             "[dim]This disclosure is required for all liquidity providers.[/]\n"
             "[dim]more information: https://docs.0xmarkets.io/legal-and-risk[/]",

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/cartha_cli/commands/register.py

@@ -68,8 +68,11 @@ def register(
     session tokens instead of passwords.
     """
 
-    assert wallet_name is not None  # nosec - enforced by Typer prompt
-    assert wallet_hotkey is not None  # nosec - enforced by Typer prompt
+    # Prompt for wallet name and hotkey if not provided
+    if wallet_name is None:
+        wallet_name = typer.prompt("Coldkey wallet name", default="default")
+    if wallet_hotkey is None:
+        wallet_hotkey = typer.prompt("Hotkey name", default="default")
 
     # Auto-map netuid and verifier URL based on network
     if network == "test":

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/docs/COMMANDS.md

@@ -872,7 +872,7 @@ cartha utils config set CARTHA_VERIFIER_URL https://your-verifier-url.com
 
 ### Signature Generation Fails
 
-- Ensure `eth-account` is installed: `uv sync`
+- Ensure `eth-account` is installed: `pip install eth-account`
 - For local signing, verify `CARTHA_EVM_PK` is set correctly
 - For external signing, follow the instructions in the generated files
 

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/docs/FEEDBACK.md

@@ -203,7 +203,7 @@ We aim to respond to:
 If you need help:
 
 1. Check the [README](../README.md) and [testnet guide](../testnet/README.md)
-2. Review command help: `uv run cartha --help`
+2. Review command help: `cartha --help`
 3. Search existing issues
 4. Ask in discussions
 5. Open an issue with your question

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cartha-cli"
-version = "1.0.0"
+version = "1.0.2"
 description = "CLI utilities for Cartha subnet miners."
 readme = "README.md"
 requires-python = ">=3.11,<3.12"
@@ -50,3 +50,6 @@ cartha = "cartha_cli:main"
 [tool.pytest.ini_options]
 addopts = "-ra"
 testpaths = ["tests"]
+
+[tool.hatchling.build.targets.wheel]
+packages = ["cartha_cli", "testnet"]

{cartha_cli-1.0.0 → cartha_cli-1.0.2}/testnet/README.md

@@ -5,7 +5,6 @@ This guide will help you set up and use the Cartha CLI on the public testnet wit
 ## Prerequisites
 
 - Python 3.11
-- [`uv`](https://github.com/astral-sh/uv) package manager (or `pip`)
 - Bittensor wallet (for subnet registration)
 - Access to the testnet verifier URL
 - Testnet TAO (required for subnet registration)
@@ -99,52 +98,18 @@ You'll need testnet TAO to register your hotkey to the subnet. Get testnet TAO f
 
 Simply visit the faucet and request testnet TAO to your wallet address. You'll need TAO in your wallet to pay for subnet registration.
 
-### Installing `uv`
-
-If you don't have `uv` installed, you can install it with:
-
-**macOS/Linux:**
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-**Windows (PowerShell):**
-
-```powershell
-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-```
-
-**Or via pip:**
-
-```bash
-pip install uv
-```
-
-After installation, restart your terminal or run `source ~/.bashrc` (or `source ~/.zshrc` on macOS).
-
 ## Installation
 
-### Option 1: Using `uv` (Recommended)
-
-`uv` automatically manages virtual environments - no need to create one manually! It will create a `.venv` directory in the project and handle all dependency isolation.
-
-```bash
-cd cartha-cli
-uv sync  # Creates .venv automatically and installs dependencies
-```
-
-Then use `uv run` to execute commands (it automatically uses the project's virtual environment):
+Install the Cartha CLI from PyPI:
 
 ```bash
-uv run cartha --help  # Runs in the project's virtual environment
+pip install cartha-cli
 ```
 
-### Option 2: Using `pip`
+Verify the installation:
 
 ```bash
-cd cartha-cli
-pip install -e .
+cartha --help
 ```
 
 ## Testnet Configuration
@@ -169,7 +134,7 @@ export BITTENSOR_WALLET_PATH="/path/to/wallet"
 
 ```bash
 # Check CLI can access verifier
-uv run cartha --help
+cartha --help
 
 # Test verifier connectivity
 curl "${CARTHA_VERIFIER_URL}/health"
@@ -195,7 +160,7 @@ You can verify your balances:
 Register your hotkey to the testnet subnet:
 
 ```bash
-uv run cartha miner register \
+cartha miner register \
   --wallet-name <your-wallet-name> \
   --wallet-hotkey <your-hotkey-name> \
   --network test \
@@ -215,7 +180,7 @@ This will:
 Use the streamlined lock flow with the Cartha Lock UI:
 
 ```bash
-uv run cartha vault lock \
+cartha vault lock \
   --coldkey <your-coldkey-name> \
   --hotkey <your-hotkey-name> \
   --pool-id BTCUSD \
@@ -257,12 +222,12 @@ This command will:
 Verify your miner status (no authentication required):
 
 ```bash
-uv run cartha miner status \
+cartha miner status \
   --wallet-name <your-wallet-name> \
   --wallet-hotkey <your-hotkey-name>
 
 # Or with explicit slot UID
-uv run cartha miner status \
+cartha miner status \
   --wallet-name <your-wallet-name> \
   --wallet-hotkey <your-hotkey-name> \
   --slot <your-slot-uid>
@@ -303,22 +268,22 @@ See `testnet/pool_ids.py` for the complete pool mappings and helper functions.
 ### Check CLI Version
 
 ```bash
-uv run cartha version
+cartha version
 ```
 
 ### View Help
 
 ```bash
-uv run cartha --help
-uv run cartha miner register --help
-uv run cartha vault lock --help
-uv run cartha miner status --help
+cartha --help
+cartha miner register --help
+cartha vault lock --help
+cartha miner status --help
 ```
 
 ### Register (Burned Registration)
 
 ```bash
-uv run cartha miner register \
+cartha miner register \
   --wallet-name <name> \
   --wallet-hotkey <hotkey> \
   --network test \
@@ -447,15 +412,15 @@ Before starting, make sure you have:
 
 ```bash
 # 1. Register your hotkey
-uv run cartha miner register --wallet-name test --wallet-hotkey test --network test --netuid 78
+cartha miner register --wallet-name test --wallet-hotkey test --network test --netuid 78
 
 # 2. Check miner status (no authentication needed)
-uv run cartha miner status --wallet-name test --wallet-hotkey test
+cartha miner status --wallet-name test --wallet-hotkey test
 
 # 3. Lock funds (interactive flow)
 # Note: Make sure you're on Base Sepolia network in MetaMask!
 # Chain ID and vault address are auto-detected from pool-id - no need to specify!
-uv run cartha vault lock \
+cartha vault lock \
   --coldkey test \
   --hotkey test \
   --pool-id BTCUSD \

cartha_cli-1.0.2/testnet/__init__.py

@@ -0,0 +1,2 @@
+"""Testnet utilities for Cartha CLI."""
+