Issues v0

.env.example

@@ -11,13 +11,17 @@ WALLET_PATH=~/.bittensor/wallets
 WALLET_NAME=default
 HOTKEY_NAME=default
 
-# For validators: Weights & Biases API key for logging
+# ******* VALIDATOR VARIABLES *******
+# Weights & Biases API key for logging
 # Signup https://wandb.ai/site for a key
 WANDB_API_KEY=
-# Optional custom name for wandb logging
+# for issue bounties api calls
+GITTENSOR_VALIDATOR_PAT=
+# Optional custom name for wandb logging 
 WANDB_VALIDATOR_NAME=vali
 
-# For miners: GitHub Personal Access Token
+# ******* MINER VARIABLES *******
+# GitHub Personal Access Token
 # https://github.com/settings/personal-access-tokens
 GITTENSOR_MINER_PAT=
 

.gitignore

@@ -19,3 +19,8 @@ wandb
 CLAUDE.md
 .claude/
 .vscode/
+
+# Rust/Cargo build artifacts
+target/
+**/*.rs.bk
+*.lock

gittensor/__init__.py

@@ -16,6 +16,6 @@
 # DEALINGS IN THE SOFTWARE.
 
 # NOTE: bump this value when updating the codebase
-__version__ = '3.2.0'
+__version__ = '4.0.0'
 version_split = __version__.split('.')
 __spec_version__ = (1000 * int(version_split[0])) + (10 * int(version_split[1])) + (1 * int(version_split[2]))

gittensor/cli/__init__.py

@@ -0,0 +1,8 @@
+# The MIT License (MIT)
+# Copyright © 2025 Entrius
+
+"""Gittensor CLI package"""
+
+from .main import cli, main
+
+__all__ = ['main', 'cli']

gittensor/cli/cli_reference_table.md

@@ -0,0 +1,42 @@
+# Gittensor CLI Reference Table (issues-v0)
+
+## Global Options
+
+All commands that interact with the network support:
+- `--network` / `-n` : Network name (`finney`, `test`, `local`). Default: `finney`
+- `--rpc-url` : Custom RPC endpoint (overrides `--network`)
+- `--wallet-name` / `--wallet.name` / `--wallet` : Wallet name
+- `--wallet-hotkey` / `--wallet.hotkey` / `--hotkey` : Hotkey name
+
+## Command Reference
+
+| CLI Command | Access | Tested | Testing Command | Notes |
+|-------------|--------|--------|-----------------|-------|
+| **Config (`gitt config`)** | | | | |
+| `gitt config` | Read | [x] | `gitt config` | Show current config |
+| `gitt config set <key> <value>` | Read | [x] | `gitt config set wallet alice` | Set config value |
+| **Issues (`gitt issues` / `gitt i`)** | | | | |
+| `gitt issues list` | Read | [x] | `gitt i list --network local --contract <ADDR>` | List all issues |
+| `gitt issues list --id <ID>` | Read | [x] | `gitt i list --id 0 --network local --contract <ADDR>` | View specific issue detail |
+| `gitt issues register` | Owner | [x] | `gitt i register --repo test/repo --issue 1 --bounty 10 --network local --contract <ADDR> --wallet alice` | Also tested non-permitted wallets cannot register. |
+| `gitt issues bounty-pool` | Read | [x] | `gitt i bounty-pool --network local --contract <ADDR>` | Sum of all issue bounty amounts |
+| `gitt issues pending-harvest` | Read | [x] | `gitt i pending-harvest --network local --contract <ADDR>` | Treasury stake minus allocated bounties |
+| **Harvest (`gitt harvest`)** | | | | |
+| `gitt harvest` | Permissionless | [x] | `gitt harvest --network local --contract <ADDR> --wallet alice --verbose` | Fixed: now fills in FIFO order |
+| **Vote (`gitt vote`)** | | | | |
+| `gitt vote solution <ID> <HOTKEY> <COLDKEY> <PR>` | Validator | [x] | `gitt vote solution 0 <HOTKEY> <COLDKEY> 1 --network local --contract <ADDR> --wallet validator1` | Triggers auto-payout on consensus |
+| `gitt vote cancel <ID> <REASON>` | Validator | [x] | `gitt vote cancel 0 "reason" --network local --contract <ADDR> --wallet validator1` | Tested: works for Registered/Active, fails for Completed/Cancelled. |
+| **Admin (`gitt admin` / `gitt a`)** | | | | |
+| `gitt admin info` | Read | [x] | `gitt a info --network local --contract <ADDR>` | View contract config (owner, treasury, netuid) |
+| `gitt admin cancel-issue <ID>` | Owner | [x] | `gitt a cancel-issue 0 --network local --contract <ADDR> --wallet alice` | Not implemented |
+| `gitt admin payout-issue <ID>` | Owner | [x] | `gitt a payout-issue 0 --network local --contract <ADDR> --wallet alice` | Not implemented - solver determined by validator consensus |
+| `gitt admin set-owner <NEW_OWNER>` | Owner | [x] | `gitt a set-owner <ADDR> --network local --contract <ADDR> --wallet alice` | |
+| `gitt admin set-treasury <NEW_TREASURY>` | Owner | [x] | `gitt a set-treasury <ADDR> --network local --contract <ADDR> --wallet alice` | |
+
+## Network Shortcuts
+
+| `--network` | RPC Endpoint |
+|-------------|-------------|
+| `finney` (default) | `wss://entrypoint-finney.opentensor.ai:443` |
+| `test` | `wss://test.finney.opentensor.ai:443` |
+| `local` | `ws://127.0.0.1:9944` |

gittensor/cli/issue_commands/__init__.py

@@ -0,0 +1,102 @@
+# The MIT License (MIT)
+# Copyright © 2025 Entrius
+
+"""
+CLI commands for managing issue bounties
+
+Command structure:
+    gitt issues (alias: i)       - Issue management commands
+        list [--id <ID>]             List issues or view a specific issue
+        register                     Register a new issue bounty
+        bounty-pool                  View total bounty pool
+        pending-harvest              View pending emissions
+    gitt harvest                 - Harvest emissions (top-level)
+    gitt vote                    - Validator consensus commands
+    gitt admin (alias: a)        - Owner-only commands
+        info                         View contract configuration
+        cancel-issue                 Cancel an issue
+        payout-issue                 Manual payout fallback
+        set-owner                    Transfer ownership
+        set-treasury                 Change treasury hotkey
+"""
+
+import click
+
+from .admin import admin
+
+# Re-export helpers
+from .helpers import (
+    CONFIG_FILE,
+    GITTENSOR_DIR,
+    NETWORK_MAP,
+    console,
+    get_contract_address,
+    load_config,
+    read_issues_from_contract,
+    resolve_network,
+)
+from .mutations import (
+    issue_harvest,
+    issue_register,
+)
+from .view import admin_info, issues_bounty_pool, issues_list, issues_pending_harvest
+from .vote import vote
+
+
+@click.group(name='issues')
+def issues_group():
+    """Issue management commands.
+
+    \b
+    Commands:
+        list              List issues or view a specific issue
+        register          Register a new issue bounty
+        bounty-pool       View total bounty pool
+        pending-harvest   View pending emissions
+    """
+    pass
+
+
+issues_group.add_command(issues_list, name='list')
+issues_group.add_command(issue_register, name='register')
+issues_group.add_command(issues_bounty_pool, name='bounty-pool')
+issues_group.add_command(issues_pending_harvest, name='pending-harvest')
+
+# Add info to admin group
+admin.add_command(admin_info, name='info')
+
+
+def register_commands(cli):
+    """Register all issue-related commands with the root CLI group."""
+    # Issues group with alias
+    cli.add_command(issues_group, name='issues')
+    cli.add_alias('issues', 'i')
+
+    # Harvest as top-level command
+    cli.add_command(issue_harvest, name='harvest')
+
+    # Validator vote group
+    cli.add_command(vote, name='vote')
+
+    # Admin group with alias
+    cli.add_command(admin)
+    cli.add_alias('admin', 'a')
+
+
+__all__ = [
+    'register_commands',
+    'issues_group',
+    'vote',
+    'admin',
+    'issue_register',
+    'issue_harvest',
+    # Helpers
+    'console',
+    'load_config',
+    'get_contract_address',
+    'resolve_network',
+    'read_issues_from_contract',
+    'GITTENSOR_DIR',
+    'CONFIG_FILE',
+    'NETWORK_MAP',
+]