nepher-cli 0.2.5__tar.gz → 0.2.6__tar.gz

{nepher_cli-0.2.5 → nepher_cli-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nepher-cli
-Version: 0.2.5
+Version: 0.2.6
 Summary: npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore
 Project-URL: Homepage, https://github.com/nepher-ai/nepher-cli
 Author: Nepher

{nepher_cli-0.2.5 → nepher_cli-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nepher-cli"
-version = "0.2.5"
+version = "0.2.6"
 description = "npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore"
 readme = "README.md"
 requires-python = ">=3.10"

{nepher_cli-0.2.5 → nepher_cli-0.2.6}/src/nepher_cli/commands/account.py

@@ -396,7 +396,7 @@ def register_coldkey(wallet: str, api_key: str, base_url: str) -> int:
 
 @click.group("account")
 def account() -> None:
-    """Manage your Nepher account — login, API keys, and coldkey registration."""
+    """Manage your Nepher account — login, API keys, coldkey, and platform balance."""
 
 
 # ── Auth ────────────────────────────────────────────────────────────────────
@@ -627,6 +627,78 @@ def api_keys_revoke(key_id: str, api_key: str | None) -> None:
 # ── Coldkey ──────────────────────────────────────────────────────────────────
 
 
+@account.command("balance")
+@click.option(
+    "--api-key", "--apikey", "api_key",
+    default=None, envvar="NEPHER_API_KEY", metavar="KEY",
+    help="Nepher API key (nepher_...). Falls back to stored credentials.",
+)
+def cmd_balance(api_key: str | None) -> None:
+    """Show platform balance used for submission fees and unlocks."""
+    headers = _require_auth(api_key)
+    url = f"{ACCOUNT_BACKEND.rstrip('/')}/api/v1/billing/balance"
+    try:
+        r = httpx.get(url, headers=headers, timeout=30.0)
+    except httpx.RequestError as e:
+        console.print(f"[red]Network error[/red]: {e}")
+        raise SystemExit(1) from e
+    if r.status_code >= 400:
+        console.print(f"[red]{parse_error_body(r.text) or r.text.strip() or f'HTTP {r.status_code}'}[/red]")
+        raise SystemExit(1)
+    body = r.json()
+    console.print(f"  Balance : [bold]{body.get('balance_tao', 0)} TAO[/bold]")
+    if body.get("coldkey"):
+        console.print(f"  Coldkey : {body['coldkey']}")
+    else:
+        console.print("  Coldkey : [yellow]not registered[/yellow] — run npcli account register-coldkey")
+    if body.get("network"):
+        console.print(f"  Network : {body['network']}")
+    console.print(
+        "  Deposit : "
+        + ("available via Account → Billing on the website" if body.get("deposit_available") else "unavailable")
+    )
+
+
+@account.command("ledger")
+@click.option("--limit", default=20, show_default=True, help="Number of ledger rows.")
+@click.option(
+    "--api-key", "--apikey", "api_key",
+    default=None, envvar="NEPHER_API_KEY", metavar="KEY",
+    help="Nepher API key (nepher_...). Falls back to stored credentials.",
+)
+def cmd_ledger(limit: int, api_key: str | None) -> None:
+    """Show recent platform billing history (deposits, fees, unlocks)."""
+    headers = _require_auth(api_key)
+    url = f"{ACCOUNT_BACKEND.rstrip('/')}/api/v1/billing/ledger"
+    try:
+        r = httpx.get(url, headers=headers, params={"limit": limit}, timeout=30.0)
+    except httpx.RequestError as e:
+        console.print(f"[red]Network error[/red]: {e}")
+        raise SystemExit(1) from e
+    if r.status_code >= 400:
+        console.print(f"[red]{parse_error_body(r.text) or r.text.strip() or f'HTTP {r.status_code}'}[/red]")
+        raise SystemExit(1)
+    items = (r.json() or {}).get("items") or []
+    if not items:
+        console.print("[dim]No billing activity yet.[/dim]")
+        return
+    table = Table(show_header=True, header_style="bold")
+    table.add_column("When")
+    table.add_column("Type")
+    table.add_column("Amount (TAO)", justify="right")
+    table.add_column("Balance after", justify="right")
+    table.add_column("Details")
+    for row in items:
+        table.add_row(
+            str(row.get("created_at") or "—"),
+            str(row.get("entry_type") or "—"),
+            f"{float(row.get('amount_tao') or 0):.6f}",
+            f"{float(row.get('balance_after_tao') or 0):.6f}",
+            str(row.get("description") or "—"),
+        )
+    console.print(table)
+
+
 @account.command("register-coldkey")
 @click.option("--wallet", required=True, metavar="NAME", help="Bittensor wallet name. Must exist in your local btcli wallet.")
 @click.option(

{nepher_cli-0.2.5 → nepher_cli-0.2.6}/src/nepher_cli/commands/tournament.py

@@ -582,16 +582,43 @@ def tournament_submit(
                 resolved_tournament_id = token_data["tournament_id"]
                 upload_token = token_data["upload_token"]
 
+                fee = token_data.get("submission_fee_tao")
+                if fee is not None:
+                    console.print(
+                        f"Submission fee: [bold]{fee} TAO[/bold] "
+                        f"(debited from platform balance on upload)"
+                    )
+                    fee_min = token_data.get("submission_fee_min_tao")
+                    fee_max = token_data.get("submission_fee_max_tao")
+                    fee_dur = token_data.get("submission_fee_duration_hours")
+                    if fee_min is not None and fee_max is not None:
+                        console.print(
+                            f"  [dim]Fee curve: {fee_max} → {fee_min} TAO"
+                            + (f" over {fee_dur}h" if fee_dur is not None else "")
+                            + "[/dim]"
+                        )
+
                 console.print("Uploading agent...")
-                agent_id = await tournament_api.upload_agent(
-                    api_key=resolved_key,
-                    api_url=resolved_url,
-                    tournament_id=resolved_tournament_id,
-                    upload_token=upload_token,
-                    miner_hotkey=miner_hotkey,
-                    content_hash=content_hash,
-                    file_path=archive,
-                )
+                try:
+                    upload_result = await tournament_api.upload_agent(
+                        api_key=resolved_key,
+                        api_url=resolved_url,
+                        tournament_id=resolved_tournament_id,
+                        upload_token=upload_token,
+                        miner_hotkey=miner_hotkey,
+                        content_hash=content_hash,
+                        file_path=archive,
+                    )
+                except tournament_api.UploadChargeError as e:
+                    console.print(f"[red]Submission fee failed:[/red] {e}")
+                    console.print(
+                        "  Check balance with [bold]npcli account balance[/bold], "
+                        "then deposit TAO on Account → Billing."
+                    )
+                    return 1
+
+                agent_id = upload_result["agent_id"]
+                charged = upload_result.get("submission_fee_tao")
 
             t_title = _tournament_title(token_data)
             t_task = _tournament_task_name(token_data)
@@ -600,6 +627,8 @@ def tournament_submit(
             console.print("[green]Agent submitted successfully.[/green]")
             console.print(f"  Agent ID     : [bold]{agent_id}[/bold]")
             console.print(f"  Tournament ID: [bold]{resolved_tournament_id}[/bold]")
+            if charged is not None:
+                console.print(f"  Fee charged  : [bold]{charged} TAO[/bold]")
             if t_title and t_title != "—":
                 console.print(f"  Title        : {t_title}")
             if t_task and t_task != "—":

{nepher_cli-0.2.5 → nepher_cli-0.2.6}/src/nepher_cli/tournament/api.py

@@ -21,6 +21,14 @@ def _json_headers(api_key: str) -> dict[str, str]:
     }
 
 
+class UploadChargeError(RuntimeError):
+    """Raised when upload fails due to payment / platform balance."""
+
+    def __init__(self, message: str, *, status_code: int = 402):
+        super().__init__(message)
+        self.status_code = status_code
+
+
 def _raise_for_error(response: httpx.Response) -> None:
     if response.status_code < 400:
         return
@@ -29,6 +37,8 @@ def _raise_for_error(response: httpx.Response) -> None:
         or response.text.strip()
         or f"HTTP {response.status_code}"
     )
+    if response.status_code == 402:
+        raise UploadChargeError(msg, status_code=402)
     raise RuntimeError(msg)
 
 
@@ -76,8 +86,11 @@ async def upload_agent(
     miner_hotkey: str,
     content_hash: str,
     file_path: Path,
-) -> str:
-    """POST /api/v1/agents/upload/{tournament_id} (multipart) → agent_id string."""
+) -> dict[str, Any]:
+    """POST /api/v1/agents/upload/{tournament_id} (multipart) → response dict.
+
+    Returns at least ``agent_id``; may include ``submission_fee_tao``.
+    """
     url = f"{api_url.rstrip('/')}/api/v1/agents/upload/{tournament_id}"
     headers = {
         "X-API-Key": api_key,
@@ -97,4 +110,8 @@ async def upload_agent(
     agent_id = data.get("id") or data.get("agent_id")
     if not agent_id:
         raise RuntimeError(f"No agent ID in upload response: {data}")
-    return str(agent_id)
+    return {
+        "agent_id": str(agent_id),
+        "submission_fee_tao": data.get("submission_fee_tao"),
+        "raw": data,
+    }