cartha-cli 1.0.5__tar.gz → 1.0.8__tar.gz

cartha_cli-1.0.8/.github/workflows/publish.yml

@@ -0,0 +1,85 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch: # Allow manual triggers
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      
+      - name: Build package
+        run: uv build
+      
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    
+    environment:
+      name: release
+      url: https://pypi.org/p/cartha-cli
+    
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+    
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch' # Only for manual runs
+    
+    environment:
+      name: test-release
+      url: https://test.pypi.org/p/cartha-cli
+    
+    permissions:
+      id-token: write
+    
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cartha-cli
-Version: 1.0.5
+Version: 1.0.8
 Summary: CLI utilities for Cartha subnet miners.
 Project-URL: Homepage, https://cartha.finance
 Project-URL: Repository, https://github.com/General-Tao-Ventures/cartha-cli
@@ -43,7 +43,7 @@ Cartha CLI makes mining on the Cartha subnet effortless. As the Liquidity Provid
 - **📊 Instant Status Updates** - See all your pools, balances, and expiration dates at a glance
 - **⏰ Smart Expiration Warnings** - Never miss a renewal with color-coded countdowns
 - **💼 Multi-Pool Management** - Track multiple trading pairs in one place
-- **🔑 Secure by Default** - Your password stays hidden until you actually need it
+- **🔒 Secure Authentication** - Session-based authentication with your Bittensor hotkey
 
 ## Installation
 
@@ -64,17 +64,19 @@ cartha miner register --help
 cartha miner status --help
 
 # Check CLI health and connectivity
-cartha health
+cartha utils health
 
 # Or use short aliases
 cartha m status
 cartha v lock
+cartha u health
 ```
 
 ## Requirements
 
 - Python 3.11
-- Bittensor wallet
+- Bittensor wallet within btcli
+    - learn how to create/import one here https://docs.learnbittensor.org/keys/working-with-keys
 
 ## What You Can Do
 
@@ -90,14 +92,12 @@ cartha miner register --wallet-name your-wallet --wallet-hotkey your-hotkey
 cartha miner status --wallet-name your-wallet --wallet-hotkey your-hotkey
 # Or use the short alias: cartha m status
 ```
-
-### Track Your Pools
-
-See all your active trading pairs, balances, and when they expire—all in one command. The CLI shows you:
-- Which pools are active and earning rewards
-- How much you have locked in each pool
-- Days remaining before expiration (with helpful warnings)
-- Which pools are included in the next reward epoch
+> **Track Your Miner Status**
+> See all your active trading pairs, balances, and when they expire—all in one command. The CLI shows you:
+> - Which pools are active and earning rewards
+> - How much you have locked in each pool
+> - Days remaining before expiration (with helpful warnings)
+> - Which pools are included in the next reward epoch
 
 ### View Available Pools
 
@@ -110,14 +110,14 @@ cartha vault pools
 
 This shows you which pools are available, their full pool IDs, vault contract addresses, and chain IDs.
 
-### Lock Your Funds
+### Lock Your Funds to start Mining
 
 Create a new lock position with the streamlined lock flow:
 ```bash
 cartha vault lock \
   --coldkey your-wallet \
   --hotkey your-hotkey \
-  --pool-id "BTCUSD" \
+  --pool-id BTCUSD \
   --amount 1000.0 \
   --lock-days 30 \
   --owner-evm 0xYourEVMAddress \
@@ -136,36 +136,31 @@ The CLI will:
 1. Check your registration on the specified network (subnet 35 for finney, subnet 78 for test)
 2. Authenticate with your Bittensor hotkey
 3. Request a signed LockRequest from the verifier
-4. Automatically open the Cartha Lock UI in your browser with all parameters pre-filled
+4. Automatically open the Cartha Lock UI in your browser with all parameters pre-filled (you can also paste the url into your browser manually)
 5. Guide you through Phase 1 (Approve USDC) and Phase 2 (Lock Position) via the web interface
 6. Automatically detect when approval completes and proceed to Phase 2
 7. The verifier automatically detects your lock and adds you to the upcoming epoch
 
 **Managing Positions**: Visit https://cartha.finance/manage to view all your positions, extend locks, or top up existing positions.
 
-### View Your Password
-
-When you need your password (like for signing transactions):
-```bash
-cartha miner password --wallet-name your-wallet --wallet-hotkey your-hotkey
-```
-
-**Tip:** Use `miner status` for daily checks—it's faster and doesn't require signing. Only use `miner password` when you actually need it.
-
 ### Check Your Setup
 
 Verify your CLI is configured correctly and can reach all services:
 
 ```bash
-cartha health
+cartha utils health
+# Or use the short alias
+cartha u health
 ```
 
 This checks:
 - Verifier connectivity and latency
 - Bittensor network connectivity
 - Configuration validation
+- Subnet metadata
+- Environment variables
 
-Use `cartha health --verbose` for detailed troubleshooting information.
+Use `cartha utils health --verbose` (or `cartha u health --verbose`) for detailed troubleshooting information.
 
 ## Need Help?
 
@@ -179,4 +174,4 @@ We welcome contributions! Please see our [Feedback & Support](docs/FEEDBACK.md)
 
 ---
 
-**Made with ❤ by GTV**
+**Made with ❤ by General Tensor**

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/README.md

@@ -10,7 +10,7 @@ Cartha CLI makes mining on the Cartha subnet effortless. As the Liquidity Provid
 - **📊 Instant Status Updates** - See all your pools, balances, and expiration dates at a glance
 - **⏰ Smart Expiration Warnings** - Never miss a renewal with color-coded countdowns
 - **💼 Multi-Pool Management** - Track multiple trading pairs in one place
-- **🔑 Secure by Default** - Your password stays hidden until you actually need it
+- **🔒 Secure Authentication** - Session-based authentication with your Bittensor hotkey
 
 ## Installation
 
@@ -31,17 +31,19 @@ cartha miner register --help
 cartha miner status --help
 
 # Check CLI health and connectivity
-cartha health
+cartha utils health
 
 # Or use short aliases
 cartha m status
 cartha v lock
+cartha u health
 ```
 
 ## Requirements
 
 - Python 3.11
-- Bittensor wallet
+- Bittensor wallet within btcli
+    - learn how to create/import one here https://docs.learnbittensor.org/keys/working-with-keys
 
 ## What You Can Do
 
@@ -57,14 +59,12 @@ cartha miner register --wallet-name your-wallet --wallet-hotkey your-hotkey
 cartha miner status --wallet-name your-wallet --wallet-hotkey your-hotkey
 # Or use the short alias: cartha m status
 ```
-
-### Track Your Pools
-
-See all your active trading pairs, balances, and when they expire—all in one command. The CLI shows you:
-- Which pools are active and earning rewards
-- How much you have locked in each pool
-- Days remaining before expiration (with helpful warnings)
-- Which pools are included in the next reward epoch
+> **Track Your Miner Status**
+> See all your active trading pairs, balances, and when they expire—all in one command. The CLI shows you:
+> - Which pools are active and earning rewards
+> - How much you have locked in each pool
+> - Days remaining before expiration (with helpful warnings)
+> - Which pools are included in the next reward epoch
 
 ### View Available Pools
 
@@ -77,14 +77,14 @@ cartha vault pools
 
 This shows you which pools are available, their full pool IDs, vault contract addresses, and chain IDs.
 
-### Lock Your Funds
+### Lock Your Funds to start Mining
 
 Create a new lock position with the streamlined lock flow:
 ```bash
 cartha vault lock \
   --coldkey your-wallet \
   --hotkey your-hotkey \
-  --pool-id "BTCUSD" \
+  --pool-id BTCUSD \
   --amount 1000.0 \
   --lock-days 30 \
   --owner-evm 0xYourEVMAddress \
@@ -103,36 +103,31 @@ The CLI will:
 1. Check your registration on the specified network (subnet 35 for finney, subnet 78 for test)
 2. Authenticate with your Bittensor hotkey
 3. Request a signed LockRequest from the verifier
-4. Automatically open the Cartha Lock UI in your browser with all parameters pre-filled
+4. Automatically open the Cartha Lock UI in your browser with all parameters pre-filled (you can also paste the url into your browser manually)
 5. Guide you through Phase 1 (Approve USDC) and Phase 2 (Lock Position) via the web interface
 6. Automatically detect when approval completes and proceed to Phase 2
 7. The verifier automatically detects your lock and adds you to the upcoming epoch
 
 **Managing Positions**: Visit https://cartha.finance/manage to view all your positions, extend locks, or top up existing positions.
 
-### View Your Password
-
-When you need your password (like for signing transactions):
-```bash
-cartha miner password --wallet-name your-wallet --wallet-hotkey your-hotkey
-```
-
-**Tip:** Use `miner status` for daily checks—it's faster and doesn't require signing. Only use `miner password` when you actually need it.
-
 ### Check Your Setup
 
 Verify your CLI is configured correctly and can reach all services:
 
 ```bash
-cartha health
+cartha utils health
+# Or use the short alias
+cartha u health
 ```
 
 This checks:
 - Verifier connectivity and latency
 - Bittensor network connectivity
 - Configuration validation
+- Subnet metadata
+- Environment variables
 
-Use `cartha health --verbose` for detailed troubleshooting information.
+Use `cartha utils health --verbose` (or `cartha u health --verbose`) for detailed troubleshooting information.
 
 ## Need Help?
 
@@ -146,4 +141,4 @@ We welcome contributions! Please see our [Feedback & Support](docs/FEEDBACK.md)
 
 ---
 
-**Made with ❤ by GTV**
+**Made with ❤ by General Tensor**

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/cartha_cli/bt.py

@@ -51,92 +51,100 @@ def register_hotkey(
     """Register a hotkey on the target subnet and return the resulting UID."""
 
     subtensor = get_subtensor(network)
-    wallet = get_wallet(wallet_name, hotkey_name)
-    hotkey_ss58 = wallet.hotkey.ss58_address
-
-    if subtensor.is_hotkey_registered(hotkey_ss58, netuid=netuid):
-        neuron = subtensor.get_neuron_for_pubkey_and_subnet(hotkey_ss58, netuid)
-        uid = None if getattr(neuron, "is_null", False) else getattr(neuron, "uid", None)
-        return RegistrationResult(status="already", success=True, uid=uid, hotkey=hotkey_ss58)
+    try:
+        wallet = get_wallet(wallet_name, hotkey_name)
+        hotkey_ss58 = wallet.hotkey.ss58_address
 
-    # Get balance before registration
-    balance_before = None
-    balance_after = None
-    extrinsic = None
+        if subtensor.is_hotkey_registered(hotkey_ss58, netuid=netuid):
+            neuron = subtensor.get_neuron_for_pubkey_and_subnet(hotkey_ss58, netuid)
+            uid = None if getattr(neuron, "is_null", False) else getattr(neuron, "uid", None)
+            return RegistrationResult(status="already", success=True, uid=uid, hotkey=hotkey_ss58)
 
-    try:
-        balance_obj = subtensor.get_balance(wallet.coldkeypub.ss58_address)
-        # Convert Balance object to float using .tao property
-        balance_before = balance_obj.tao if hasattr(balance_obj, "tao") else float(balance_obj)
-    except Exception:
-        pass  # Balance may not be available, continue anyway
-
-    if burned:
-        # burned_register returns (success, block_info) or just success
-        registration_result = subtensor.burned_register(
-            wallet=wallet,
-            netuid=netuid,
-            wait_for_finalization=wait_for_finalization,
-        )
+        # Get balance before registration
+        balance_before = None
+        balance_after = None
+        extrinsic = None
 
-        # Handle both return types: bool or (bool, message)
-        if isinstance(registration_result, tuple):
-            ok, message = registration_result
-            if isinstance(message, str) and message:
-                extrinsic = message
+        try:
+            balance_obj = subtensor.get_balance(wallet.coldkeypub.ss58_address)
+            # Convert Balance object to float using .tao property
+            balance_before = balance_obj.tao if hasattr(balance_obj, "tao") else float(balance_obj)
+        except Exception:
+            pass  # Balance may not be available, continue anyway
+
+        if burned:
+            # burned_register returns (success, block_info) or just success
+            registration_result = subtensor.burned_register(
+                wallet=wallet,
+                netuid=netuid,
+                wait_for_finalization=wait_for_finalization,
+            )
+
+            # Handle both return types: bool or (bool, message)
+            if isinstance(registration_result, tuple):
+                ok, message = registration_result
+                if isinstance(message, str) and message:
+                    extrinsic = message
+            else:
+                ok = registration_result
+
+            status = "burned"
         else:
-            ok = registration_result
-
-        status = "burned"
-    else:
-        ok = subtensor.register(
-            wallet=wallet,
-            netuid=netuid,
-            wait_for_finalization=wait_for_finalization,
-            wait_for_inclusion=wait_for_inclusion,
-            cuda=cuda,
-            dev_id=dev_id,
-            tpb=tpb,
-            num_processes=num_processes,
-            log_verbose=False,
-        )
-        status = "pow"
-        if isinstance(ok, tuple) and len(ok) == 2:
-            ok, message = ok
-            if isinstance(message, str):
-                extrinsic = message
+            ok = subtensor.register(
+                wallet=wallet,
+                netuid=netuid,
+                wait_for_finalization=wait_for_finalization,
+                wait_for_inclusion=wait_for_inclusion,
+                cuda=cuda,
+                dev_id=dev_id,
+                tpb=tpb,
+                num_processes=num_processes,
+                log_verbose=False,
+            )
+            status = "pow"
+            if isinstance(ok, tuple) and len(ok) == 2:
+                ok, message = ok
+                if isinstance(message, str):
+                    extrinsic = message
+
+        if not ok:
+            return RegistrationResult(
+                status=status,
+                success=False,
+                uid=None,
+                hotkey=hotkey_ss58,
+                balance_before=balance_before,
+                balance_after=balance_after,
+                extrinsic=extrinsic,
+            )
+
+        # Get balance after registration
+        try:
+            balance_obj = subtensor.get_balance(wallet.coldkeypub.ss58_address)
+            # Convert Balance object to float using .tao property
+            balance_after = balance_obj.tao if hasattr(balance_obj, "tao") else float(balance_obj)
+        except Exception:
+            pass
+
+        neuron = subtensor.get_neuron_for_pubkey_and_subnet(hotkey_ss58, netuid)
+        uid = None if getattr(neuron, "is_null", False) else getattr(neuron, "uid", None)
 
-    if not ok:
         return RegistrationResult(
             status=status,
-            success=False,
-            uid=None,
+            success=True,
+            uid=uid,
             hotkey=hotkey_ss58,
             balance_before=balance_before,
             balance_after=balance_after,
             extrinsic=extrinsic,
         )
-
-    # Get balance after registration
-    try:
-        balance_obj = subtensor.get_balance(wallet.coldkeypub.ss58_address)
-        # Convert Balance object to float using .tao property
-        balance_after = balance_obj.tao if hasattr(balance_obj, "tao") else float(balance_obj)
-    except Exception:
-        pass
-
-    neuron = subtensor.get_neuron_for_pubkey_and_subnet(hotkey_ss58, netuid)
-    uid = None if getattr(neuron, "is_null", False) else getattr(neuron, "uid", None)
-
-    return RegistrationResult(
-        status=status,
-        success=True,
-        uid=uid,
-        hotkey=hotkey_ss58,
-        balance_before=balance_before,
-        balance_after=balance_after,
-        extrinsic=extrinsic,
-    )
+    finally:
+        # Clean up subtensor connection
+        try:
+            if hasattr(subtensor, "close"):
+                subtensor.close()
+        except Exception:
+            pass  # Silently ignore cleanup errors
 
 
 def get_burn_cost(network: str, netuid: int) -> float | None:

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/cartha_cli/commands/config.py

@@ -17,7 +17,7 @@ from .common import console
 ENV_VAR_DOCS: dict[str, dict[str, Any]] = {
     "CARTHA_VERIFIER_URL": {
         "description": "URL of the Cartha verifier service",
-        "default": "https://cartha-verifier-826542474079.us-central1.run.app",
+        "default": "https://cartha-verifier-193291340038.us-central1.run.app",
         "required": False,
     },
     "CARTHA_NETWORK": {

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/cartha_cli/commands/miner_password.py

@@ -69,13 +69,6 @@ def miner_password(
             netuid = 78
         elif network == "finney":
             netuid = 35
-            # Warn that mainnet is not live yet
-            console.print()
-            console.print("[bold yellow]⚠️  MAINNET NOT AVAILABLE YET[/]")
-            console.print("[yellow]Cartha subnet is currently in testnet phase (subnet 78).[/]")
-            console.print("[yellow]Mainnet (subnet 35) has not been announced yet.[/]")
-            console.print("[dim]Use --network test to access testnet.[/]")
-            console.print()
         # Note: netuid parameter is kept for backwards compatibility / explicit override
         
         from ..config import get_verifier_url_for_network

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/cartha_cli/commands/miner_status.py

@@ -79,13 +79,6 @@ def miner_status(
             netuid = 78
         elif network == "finney":
             netuid = 35
-            # Warn that mainnet is not live yet
-            console.print()
-            console.print("[bold yellow]⚠️  MAINNET NOT AVAILABLE YET[/]")
-            console.print("[yellow]Cartha subnet is currently in testnet phase (subnet 78).[/]")
-            console.print("[yellow]Mainnet (subnet 35) has not been announced yet.[/]")
-            console.print("[dim]Use --network test to access testnet.[/]")
-            console.print()
         # Note: netuid parameter is kept for backwards compatibility / explicit override
         
         from ..config import get_verifier_url_for_network
@@ -488,25 +481,14 @@ def miner_status(
 
             console.print(pool_table)
 
-        # Concise reminder
-        console.print()
-        console.print("[bold cyan]━━━ Reminders ━━━[/]")
-        console.print(
-            "• Lock expiration: USDC returned automatically, emissions stop for that pool."
-        )
-        console.print(
-            "• Top-ups/extensions: Happen automatically on-chain. No CLI action needed."
-        )
-        if pools and len(pools) > 1:
-            console.print(
-                "• Multiple pools: Each pool is tracked separately. Expired pools stop earning, others continue."
-            )
-        
         # Link to web interface
         console.print()
         console.print("[bold cyan]━━━ Web Interface ━━━[/]")
         console.print(
-            "[cyan]🌐 View and manage your positions:[/] [bold]https://cartha.finance[/]"
+            "[cyan]🌐 Manage your positions:[/] [bold]https://cartha.finance[/]"
+        )
+        console.print(
+            "[dim]  • Deposit new lock positions[/]"
         )
         console.print(
             "[dim]  • View all your lock positions[/]"
@@ -517,8 +499,5 @@ def miner_status(
         console.print(
             "[dim]  • Top up existing positions[/]"
         )
-        console.print(
-            "[dim]  • Claim testnet USDC from faucet[/]"
-        )
 
     return

{cartha_cli-1.0.5 → cartha_cli-1.0.8}/cartha_cli/commands/pair_status.py

@@ -34,26 +34,8 @@ from .shared_options import (
     json_output_option,
 )
 
-# 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, ModuleNotFoundError):
-    # Use fallback function
-    pool_id_to_name = _fallback_pool_id_to_name
+# Import pool name helper from pool_client (fetches from verifier API)
+from ..pool_client import pool_id_to_name
 
 
 def pair_status(
@@ -100,13 +82,6 @@ def pair_status(
             netuid = 78
         elif network == "finney":
             netuid = 35
-            # Warn that mainnet is not live yet
-            console.print()
-            console.print("[bold yellow]⚠️  MAINNET NOT AVAILABLE YET[/]")
-            console.print("[yellow]Cartha subnet is currently in testnet phase (subnet 78).[/]")
-            console.print("[yellow]Mainnet (subnet 35) has not been announced yet.[/]")
-            console.print("[dim]Use --network test to access testnet.[/]")
-            console.print()
         # Note: netuid parameter is kept for backwards compatibility / explicit override
         
         from ..config import get_verifier_url_for_network