nepher-cli-test 0.2.7__tar.gz → 0.2.8__tar.gz

{nepher_cli_test-0.2.7 → nepher_cli_test-0.2.8}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: nepher-cli-test
-Version: 0.2.7
-Summary: npcli-test — Nepher CLI for staging (api.staging.nepher.ai)
+Version: 0.2.8
+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
 License: MIT
@@ -26,90 +26,76 @@ Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.4.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
-# nepher-cli-test
+# nepher-cli
 
-**Staging build** of the [Nepher CLI](https://github.com/nepher-ai/nepher-cli) — same commands as production, but defaults to **staging APIs** (`api.staging.nepher.ai`).
-
-For production, use [`nepher-cli`](https://pypi.org/project/nepher-cli/) and the `npcli` command instead.
+The unified CLI for [Nepher Robotics](https://nepher.ai) — accounts, hackathons, EnvHub, tournaments, and SimStore from a single tool.
 
 **Requires:** Python 3.10+
 
 ## Install
 
 ```bash
-pip install nepher-cli-test
+pip install nepher-cli
 ```
 
-The `npcli-test` command is registered after install.
+Both `npcli` and `nepher-cli` entry points are registered after install.
 
 ```bash
-npcli-test --version
-npcli-test --help
+npcli --version
+npcli --help
 ```
 
-## Staging API endpoints
-
-| Service | Default base |
-|---------|--------------|
-| Account | `https://api.staging.nepher.ai/account` |
-| Tournament | `https://api.staging.nepher.ai/tournament` |
-| EnvHub | `https://api.staging.nepher.ai/envhub` |
-| Hackathon | `https://api.staging.nepher.ai/hackathon` |
-| SimStore | `https://simstore-staging.nepher.ai` |
-
-Override with `NEPHER_API_URL` (and service-specific vars) if needed.
-
 ## Commands
 
 | Command / Group | Description |
 |-----------------|-------------|
-| `npcli-test login` | Log in with a Nepher API key |
-| `npcli-test whoami` | Show the currently authenticated user |
-| `npcli-test logout` | Clear locally stored credentials |
-| `npcli-test account` | API keys and coldkey registration |
-| `npcli-test tournament` | Browse tournaments, submit agents, leaderboards |
-| `npcli-test envhub` | Manage Isaac Lab environment bundles |
-| `npcli-test hackathon` | Browse and submit to hackathons |
-| `npcli-test simstore` | SimStore marketplace *(coming soon)* |
+| `npcli login` | Log in with a Nepher API key |
+| `npcli whoami` | Show the currently authenticated user |
+| `npcli logout` | Clear locally stored credentials |
+| `npcli account` | API keys and coldkey registration |
+| `npcli tournament` | Browse tournaments, submit agents, leaderboards |
+| `npcli envhub` | Manage Isaac Lab environment bundles |
+| `npcli hackathon` | Browse and submit to hackathons |
+| `npcli simstore` | SimStore marketplace *(coming soon)* |
 
 ## Quick Start
 
 ### Authenticate
 
 ```bash
-npcli-test login --api-key nepher_xxxxxxxx
-npcli-test whoami
-npcli-test logout
+npcli login --api-key nepher_xxxxxxxx
+npcli whoami
+npcli logout
 ```
 
-Get a staging API key at [staging.nepher.ai/account](https://staging.nepher.ai/account) → Account → API Keys.  
+Get your API key at [nepher.ai/account](https://nepher.ai/account) → Account → API Keys.  
 For CI/CD, set `NEPHER_API_KEY=nepher_xxxxxxxx` instead of logging in.
 
 ### Tournaments
 
 ```bash
-npcli-test tournament list
-npcli-test tournament list-active
-npcli-test tournament status <tournament_id>
-npcli-test tournament leaderboard <tournament_id>
+npcli tournament list
+npcli tournament list-active
+npcli tournament status <tournament_id>
+npcli tournament leaderboard <tournament_id>
 ```
 
 Check your agent directory structure (no extra dependencies needed):
 
 ```bash
-npcli-test tournament check --path ./my-agent
-npcli-test tournament check --path ./my-agent --verbose   # also show recommended-file warnings
+npcli tournament check --path ./my-agent
+npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings
 ```
 
 Submit an agent (requires `bittensor-wallet` for wallet signing):
 
 ```bash
 pip install bittensor-wallet
-# or: pip install "nepher-cli-test[bittensor]"
+# or: pip install "nepher-cli[bittensor]"
 ```
 
 ```bash
-npcli-test tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default
+npcli tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default
 ```
 
 Full options for `submit`:
@@ -127,20 +113,20 @@ Full options for `submit`:
 ### EnvHub
 
 ```bash
-npcli-test envhub list
-npcli-test envhub download <env_id>
-npcli-test envhub upload ./my-bundle --category navigation
-npcli-test envhub cache list
-npcli-test envhub cache info
-npcli-test envhub cache clear
+npcli envhub list
+npcli envhub download <env_id>
+npcli envhub upload ./my-bundle --category navigation
+npcli envhub cache list
+npcli envhub cache info
+npcli envhub cache clear
 ```
 
 ### Hackathons
 
 ```bash
-npcli-test hackathon list
+npcli hackathon list
 
-npcli-test hackathon submit \
+npcli hackathon submit \
   --title "My entry" \
   --submission ./my-project \
   --assets ./my-assets
@@ -160,14 +146,14 @@ Full options:
 
 ### API Keys
 
-`list` / `create` / `revoke` need a **JWT session** from `npcli-test account login`.  
+`list` / `create` / `revoke` need a **JWT session** from `npcli account login`.  
 Do **not** pass `--api-key` on these commands (that flag sends `X-API-Key`, which the account API rejects for key management).
 
 ```bash
-npcli-test account login --api-key nepher_...
-npcli-test account api-keys list
-npcli-test account api-keys create --name "CI key" --platform hackathon
-npcli-test account api-keys revoke <key_id>
+npcli account login --api-key nepher_...
+npcli account api-keys list
+npcli account api-keys create --name "CI key" --platform hackathon
+npcli account api-keys revoke <key_id>
 ```
 
 ### Coldkey Registration
@@ -176,7 +162,7 @@ Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` i
 
 ```bash
 pip install bittensor-wallet
-npcli-test account register-coldkey --wallet <wallet_name>
+npcli account register-coldkey --wallet <wallet_name>
 ```
 
 Signing uses the local coldkey via `bittensor-wallet` and does not import `btcli`. If you still have a mixed Bittensor venv (`scalecodec` + `cyscale`), `register-coldkey` keeps working as long as `bittensor-wallet` is installed.
@@ -192,21 +178,21 @@ Signing uses the local coldkey via `bittensor-wallet` and does not import `btcli
 
 | Error | Fix |
 |-------|-----|
-| `npcli-test: command not found` | Ensure `pip install` succeeded and Python scripts dir is on `PATH` |
+| `npcli: command not found` | Ensure `pip install` succeeded and Python scripts dir is on `PATH` |
 | `invalid api key format` | Key must start with `nepher_` |
 | `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
-| `api key expired` | Run `npcli-test account api-keys create` |
+| `api key expired` | Run `npcli account api-keys create` |
 | `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
 | `bittensor-wallet not installed` | `pip install bittensor-wallet` (needed for `tournament submit` and `account register-coldkey`) |
-| `Not logged in` | `npcli-test login --api-key nepher_...` |
-| `Conflict detected: 'scalecodec' ... conflicts with 'cyscale'` | Leftover `scalecodec` after a Bittensor upgrade. Prefer `pip install bittensor-wallet` so npcli-test never needs `btcli`. To repair `btcli` itself: `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
+| `Not logged in` | `npcli login --api-key nepher_...` |
+| `Conflict detected: 'scalecodec' ... conflicts with 'cyscale'` | Leftover `scalecodec` after a Bittensor upgrade. Prefer `pip install bittensor-wallet` so npcli never needs `btcli`. To repair `btcli` itself: `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
 
 Run any command with `--help` for full flag details:
 
 ```bash
-npcli-test --help
-npcli-test hackathon submit --help
-npcli-test tournament submit --help
+npcli --help
+npcli hackathon submit --help
+npcli tournament submit --help
 ```
 
 ## License

nepher_cli_test-0.2.8/README.md

@@ -0,0 +1,172 @@
+# nepher-cli
+
+The unified CLI for [Nepher Robotics](https://nepher.ai) — accounts, hackathons, EnvHub, tournaments, and SimStore from a single tool.
+
+**Requires:** Python 3.10+
+
+## Install
+
+```bash
+pip install nepher-cli
+```
+
+Both `npcli` and `nepher-cli` entry points are registered after install.
+
+```bash
+npcli --version
+npcli --help
+```
+
+## Commands
+
+| Command / Group | Description |
+|-----------------|-------------|
+| `npcli login` | Log in with a Nepher API key |
+| `npcli whoami` | Show the currently authenticated user |
+| `npcli logout` | Clear locally stored credentials |
+| `npcli account` | API keys and coldkey registration |
+| `npcli tournament` | Browse tournaments, submit agents, leaderboards |
+| `npcli envhub` | Manage Isaac Lab environment bundles |
+| `npcli hackathon` | Browse and submit to hackathons |
+| `npcli simstore` | SimStore marketplace *(coming soon)* |
+
+## Quick Start
+
+### Authenticate
+
+```bash
+npcli login --api-key nepher_xxxxxxxx
+npcli whoami
+npcli logout
+```
+
+Get your API key at [nepher.ai/account](https://nepher.ai/account) → Account → API Keys.  
+For CI/CD, set `NEPHER_API_KEY=nepher_xxxxxxxx` instead of logging in.
+
+### Tournaments
+
+```bash
+npcli tournament list
+npcli tournament list-active
+npcli tournament status <tournament_id>
+npcli tournament leaderboard <tournament_id>
+```
+
+Check your agent directory structure (no extra dependencies needed):
+
+```bash
+npcli tournament check --path ./my-agent
+npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings
+```
+
+Submit an agent (requires `bittensor-wallet` for wallet signing):
+
+```bash
+pip install bittensor-wallet
+# or: pip install "nepher-cli[bittensor]"
+```
+
+```bash
+npcli tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default
+```
+
+Full options for `submit`:
+
+```
+--path <path>               Agent directory
+--wallet-name <str>         Bittensor wallet name (default: miner)
+--wallet-hotkey <str>       Bittensor wallet hotkey (default: default)
+--api-key <key>             Nepher API key (falls back to stored credentials)
+--tournament-id <id>        Target tournament ID (required when multiple are active)
+--api-url <url>             Override tournament API URL
+-v / --verbose              Verbose output
+```
+
+### EnvHub
+
+```bash
+npcli envhub list
+npcli envhub download <env_id>
+npcli envhub upload ./my-bundle --category navigation
+npcli envhub cache list
+npcli envhub cache info
+npcli envhub cache clear
+```
+
+### Hackathons
+
+```bash
+npcli hackathon list
+
+npcli hackathon submit \
+  --title "My entry" \
+  --submission ./my-project \
+  --assets ./my-assets
+```
+
+Full options:
+
+```
+--hackathon-id <uuid>       Required when multiple hackathons are open
+--title <str>               Entry title
+--description <markdown>    Entry description
+--thumbnail <file>          Cover image (JPEG, PNG, WebP, GIF)
+--submission <path>         Project folder or submission.zip
+--assets <path>             Assets folder or assets.zip (images, videos, PDFs)
+--public-source             Mark source as public
+```
+
+### API Keys
+
+`list` / `create` / `revoke` need a **JWT session** from `npcli account login`.  
+Do **not** pass `--api-key` on these commands (that flag sends `X-API-Key`, which the account API rejects for key management).
+
+```bash
+npcli account login --api-key nepher_...
+npcli account api-keys list
+npcli account api-keys create --name "CI key" --platform hackathon
+npcli account api-keys revoke <key_id>
+```
+
+### Coldkey Registration
+
+Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` is optional fallback):
+
+```bash
+pip install bittensor-wallet
+npcli account register-coldkey --wallet <wallet_name>
+```
+
+Signing uses the local coldkey via `bittensor-wallet` and does not import `btcli`. If you still have a mixed Bittensor venv (`scalecodec` + `cyscale`), `register-coldkey` keeps working as long as `bittensor-wallet` is installed.
+
+## API Key Requirements
+
+- Must start with `nepher_`
+- Must be active and not expired
+- `hackathon submit` requires **Hackathon** scope (or an unrestricted key)
+- `tournament submit` requires **Tournament** scope (or an unrestricted key)
+
+## Troubleshooting
+
+| Error | Fix |
+|-------|-----|
+| `npcli: command not found` | Ensure `pip install` succeeded and Python scripts dir is on `PATH` |
+| `invalid api key format` | Key must start with `nepher_` |
+| `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
+| `api key expired` | Run `npcli account api-keys create` |
+| `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
+| `bittensor-wallet not installed` | `pip install bittensor-wallet` (needed for `tournament submit` and `account register-coldkey`) |
+| `Not logged in` | `npcli login --api-key nepher_...` |
+| `Conflict detected: 'scalecodec' ... conflicts with 'cyscale'` | Leftover `scalecodec` after a Bittensor upgrade. Prefer `pip install bittensor-wallet` so npcli never needs `btcli`. To repair `btcli` itself: `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
+
+Run any command with `--help` for full flag details:
+
+```bash
+npcli --help
+npcli hackathon submit --help
+npcli tournament submit --help
+```
+
+## License
+
+MIT

{nepher_cli_test-0.2.7 → nepher_cli_test-0.2.8}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nepher-cli-test"
-version = "0.2.7"
-description = "npcli-test — Nepher CLI for staging (api.staging.nepher.ai)"
-readme = "README.test.md"
+version = "0.2.8"
+description = "npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore"
+readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
 authors = [{ name = "Nepher" }]
@@ -36,7 +36,8 @@ dev = [
 ]
 
 [project.scripts]
-npcli-test = "nepher_cli.cli_test:main"
+npcli      = "nepher_cli.cli:main"
+nepher-cli = "nepher_cli.cli:main"
 
 [project.urls]
 Homepage = "https://github.com/nepher-ai/nepher-cli"
@@ -46,7 +47,7 @@ packages = ["src/nepher_cli"]
 core-metadata-version = "2.4"
 
 [tool.hatch.build.targets.sdist]
-include = ["src/nepher_cli", "README.test.md", "pyproject.toml"]
+include = ["src/nepher_cli", "README.md", "pyproject.toml"]
 core-metadata-version = "2.4"
 
 [tool.ruff]

nepher_cli_test-0.2.8/src/nepher_cli/__init__.py

@@ -0,0 +1,10 @@
+"""npcli — unified Nepher command-line interface."""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("nepher-cli")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.0.0"

{nepher_cli_test-0.2.7 → nepher_cli_test-0.2.8}/src/nepher_cli/cli.py

@@ -15,7 +15,7 @@ from nepher_cli.commands.tournament import tournament
 @click.group(
     context_settings={"help_option_names": ["-h", "--help"], "max_content_width": 100},
 )
-@click.version_option(version=__version__)
+@click.version_option(version=__version__, package_name="nepher-cli", prog_name="npcli")
 def main() -> None:
     """npcli — the unified Nepher command-line interface.
 
@@ -39,6 +39,11 @@ def main() -> None:
       npcli envhub list
       npcli tournament list
 
+    \b
+    Tournament submit requires bittensor-wallet for wallet signing:
+      pip install bittensor-wallet
+      # or: pip install "nepher-cli[bittensor]"
+
     Run any sub-command with --help for details and examples.
 
     API keys are created at https://nepher.ai/account (Account > API Keys).

{nepher_cli_test-0.2.7 → nepher_cli_test-0.2.8}/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_test-0.2.7 → nepher_cli_test-0.2.8}/src/nepher_cli/commands/tournament.py

@@ -530,6 +530,7 @@ def tournament_submit(
 
     Requires [bold]bittensor-wallet[/bold] for wallet signing:
       pip install bittensor-wallet
+      # or: pip install "nepher-cli[bittensor]"
     """
     resolved_key = _resolve_api_key(api_key)
     resolved_url = api_url or TOURNAMENT_BACKEND
@@ -581,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)
@@ -599,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_test-0.2.7 → nepher_cli_test-0.2.8}/src/nepher_cli/config.py

@@ -5,10 +5,8 @@ from __future__ import annotations
 import os
 
 # Unified public API host (embedded product mounts). SimStore stays separate.
-DEFAULT_WEBSITE_API = "https://api.nepher.ai"
-STAGING_WEBSITE_API = "https://api.staging.nepher.ai"
-SIMSTORE_BACKEND_DEFAULT = "https://api.simstore.nepher.ai"
-STAGING_SIMSTORE_BACKEND = "https://simstore-staging.nepher.ai"
+DEFAULT_WEBSITE_API = "https://api.staing.nepher.ai"
+SIMSTORE_BACKEND_DEFAULT = "https://api.simstore-staging.nepher.ai"
 
 
 def website_api_base() -> str:

{nepher_cli_test-0.2.7 → nepher_cli_test-0.2.8}/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,
+    }

nepher_cli_test-0.2.7/README.test.md

@@ -1,186 +0,0 @@
-# nepher-cli-test
-
-**Staging build** of the [Nepher CLI](https://github.com/nepher-ai/nepher-cli) — same commands as production, but defaults to **staging APIs** (`api.staging.nepher.ai`).
-
-For production, use [`nepher-cli`](https://pypi.org/project/nepher-cli/) and the `npcli` command instead.
-
-**Requires:** Python 3.10+
-
-## Install
-
-```bash
-pip install nepher-cli-test
-```
-
-The `npcli-test` command is registered after install.
-
-```bash
-npcli-test --version
-npcli-test --help
-```
-
-## Staging API endpoints
-
-| Service | Default base |
-|---------|--------------|
-| Account | `https://api.staging.nepher.ai/account` |
-| Tournament | `https://api.staging.nepher.ai/tournament` |
-| EnvHub | `https://api.staging.nepher.ai/envhub` |
-| Hackathon | `https://api.staging.nepher.ai/hackathon` |
-| SimStore | `https://simstore-staging.nepher.ai` |
-
-Override with `NEPHER_API_URL` (and service-specific vars) if needed.
-
-## Commands
-
-| Command / Group | Description |
-|-----------------|-------------|
-| `npcli-test login` | Log in with a Nepher API key |
-| `npcli-test whoami` | Show the currently authenticated user |
-| `npcli-test logout` | Clear locally stored credentials |
-| `npcli-test account` | API keys and coldkey registration |
-| `npcli-test tournament` | Browse tournaments, submit agents, leaderboards |
-| `npcli-test envhub` | Manage Isaac Lab environment bundles |
-| `npcli-test hackathon` | Browse and submit to hackathons |
-| `npcli-test simstore` | SimStore marketplace *(coming soon)* |
-
-## Quick Start
-
-### Authenticate
-
-```bash
-npcli-test login --api-key nepher_xxxxxxxx
-npcli-test whoami
-npcli-test logout
-```
-
-Get a staging API key at [staging.nepher.ai/account](https://staging.nepher.ai/account) → Account → API Keys.  
-For CI/CD, set `NEPHER_API_KEY=nepher_xxxxxxxx` instead of logging in.
-
-### Tournaments
-
-```bash
-npcli-test tournament list
-npcli-test tournament list-active
-npcli-test tournament status <tournament_id>
-npcli-test tournament leaderboard <tournament_id>
-```
-
-Check your agent directory structure (no extra dependencies needed):
-
-```bash
-npcli-test tournament check --path ./my-agent
-npcli-test tournament check --path ./my-agent --verbose   # also show recommended-file warnings
-```
-
-Submit an agent (requires `bittensor-wallet` for wallet signing):
-
-```bash
-pip install bittensor-wallet
-# or: pip install "nepher-cli-test[bittensor]"
-```
-
-```bash
-npcli-test tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default
-```
-
-Full options for `submit`:
-
-```
---path <path>               Agent directory
---wallet-name <str>         Bittensor wallet name (default: miner)
---wallet-hotkey <str>       Bittensor wallet hotkey (default: default)
---api-key <key>             Nepher API key (falls back to stored credentials)
---tournament-id <id>        Target tournament ID (required when multiple are active)
---api-url <url>             Override tournament API URL
--v / --verbose              Verbose output
-```
-
-### EnvHub
-
-```bash
-npcli-test envhub list
-npcli-test envhub download <env_id>
-npcli-test envhub upload ./my-bundle --category navigation
-npcli-test envhub cache list
-npcli-test envhub cache info
-npcli-test envhub cache clear
-```
-
-### Hackathons
-
-```bash
-npcli-test hackathon list
-
-npcli-test hackathon submit \
-  --title "My entry" \
-  --submission ./my-project \
-  --assets ./my-assets
-```
-
-Full options:
-
-```
---hackathon-id <uuid>       Required when multiple hackathons are open
---title <str>               Entry title
---description <markdown>    Entry description
---thumbnail <file>          Cover image (JPEG, PNG, WebP, GIF)
---submission <path>         Project folder or submission.zip
---assets <path>             Assets folder or assets.zip (images, videos, PDFs)
---public-source             Mark source as public
-```
-
-### API Keys
-
-`list` / `create` / `revoke` need a **JWT session** from `npcli-test account login`.  
-Do **not** pass `--api-key` on these commands (that flag sends `X-API-Key`, which the account API rejects for key management).
-
-```bash
-npcli-test account login --api-key nepher_...
-npcli-test account api-keys list
-npcli-test account api-keys create --name "CI key" --platform hackathon
-npcli-test account api-keys revoke <key_id>
-```
-
-### Coldkey Registration
-
-Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` is optional fallback):
-
-```bash
-pip install bittensor-wallet
-npcli-test account register-coldkey --wallet <wallet_name>
-```
-
-Signing uses the local coldkey via `bittensor-wallet` and does not import `btcli`. If you still have a mixed Bittensor venv (`scalecodec` + `cyscale`), `register-coldkey` keeps working as long as `bittensor-wallet` is installed.
-
-## API Key Requirements
-
-- Must start with `nepher_`
-- Must be active and not expired
-- `hackathon submit` requires **Hackathon** scope (or an unrestricted key)
-- `tournament submit` requires **Tournament** scope (or an unrestricted key)
-
-## Troubleshooting
-
-| Error | Fix |
-|-------|-----|
-| `npcli-test: command not found` | Ensure `pip install` succeeded and Python scripts dir is on `PATH` |
-| `invalid api key format` | Key must start with `nepher_` |
-| `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
-| `api key expired` | Run `npcli-test account api-keys create` |
-| `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
-| `bittensor-wallet not installed` | `pip install bittensor-wallet` (needed for `tournament submit` and `account register-coldkey`) |
-| `Not logged in` | `npcli-test login --api-key nepher_...` |
-| `Conflict detected: 'scalecodec' ... conflicts with 'cyscale'` | Leftover `scalecodec` after a Bittensor upgrade. Prefer `pip install bittensor-wallet` so npcli-test never needs `btcli`. To repair `btcli` itself: `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
-
-Run any command with `--help` for full flag details:
-
-```bash
-npcli-test --help
-npcli-test hackathon submit --help
-npcli-test tournament submit --help
-```
-
-## License
-
-MIT

nepher_cli_test-0.2.7/src/nepher_cli/__init__.py

@@ -1,3 +0,0 @@
-"""npcli — unified Nepher command-line interface."""
-
-__version__ = "0.2.7"

nepher_cli_test-0.2.7/src/nepher_cli/cli_test.py

@@ -1,19 +0,0 @@
-"""npcli-test — staging entry point (defaults to api.staging.nepher.ai)."""
-
-from __future__ import annotations
-
-import os
-
-# Set staging defaults before any nepher_cli submodule imports config.
-os.environ.setdefault("NEPHER_API_URL", "https://api.staging.nepher.ai")
-os.environ.setdefault("NEPHER_SIMSTORE_API_URL", "https://simstore-staging.nepher.ai")
-
-
-def main() -> None:
-    from nepher_cli.cli import main as cli_main
-
-    cli_main()
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())