{"service":"verathos-miner-debug","enabled_by_default":false,"endpoints":{"uid_summary":"/v1/miner-debug/{uid}?window_h=24","executor_model_index":"/v1/miner-debug/{uid}/entries/{model_index}?window_h=24"},"examples":{"uid_summary":"/v1/miner-debug/58?window_h=24","executor_model_index":"/v1/miner-debug/58/entries/62?window_h=24"},"parameters":{"uid":"Bittensor UID on subnet 96.","model_index":"Executor/model index shown for the row on the dashboard.","window_h":"Requested diagnostic window in hours, 1..48. The proxy serves the nearest cached window."},"windows_h":[24,48],"description":"Cached, public miner diagnostics built by an opted-in validator and served read-only by the proxy.","usage":["Use the UID summary to see UID-wide gates and all recent entries.","Use the executor model_index endpoint for the specific row shown on the dashboard.","Read primary_issue, then inspect the matching entry issue_codes and next_steps.","Use window_h=48 when a 24-hour report does not explain an older probation or audit event."],"agent_workflow":["GET /v1/miner-debug/help once to learn the response schema.","GET /v1/miner-debug/{uid}?window_h=24.","For each affected row, GET /v1/miner-debug/{uid}/entries/{model_index}?window_h=24.","Report identity, primary_issue, issue_codes, gate/probation recovery fields, and next_steps."],"response_fields":{"primary_issue":"Best-effort top-level reason for the UID state.","identity":"Current hotkey/EVM generation for this reusable Bittensor UID slot.","summary":"Active/recent entry counts, probation count, best score, and latest scored epoch.","network":"This validator's last successfully set weight plus cached metagraph hotkey, incentive, emission, trust, consensus, and metagraph block.","uid_gate":"UID-wide capacity-audit gate state, thresholds, convicted entries, and recovery estimate.","entries":"Per-executor diagnostics keyed by model_index.","entry.capacity_audit.gate_status":"Whether that executor is currently audit-gated and when it can clear if no new failures arrive.","entry.probation":"Probation state, clean passes, required passes, and remaining clean passes.","entry.canary":"Recent validator canary counts, error kinds, recent errors, and last error kind.","entry.receipts":"Recent receipt counts and observed average throughput.","entry.last_score":"Latest closed-epoch scoring row for that executor.","entry.model_gate":"Current model/GPU eligibility gate and its reason.","entry.blacklisted":"Whether subnet configuration currently blacklists the miner address.","hints":"Human-readable explanations for the issue codes.","next_steps":"Concrete operator actions inferred from the cached diagnostics."},"issue_codes":{"healthy":"No obvious issue in the cached window.","new_entry_not_scored":"The active endpoint has not closed a scored epoch yet.","local_weight_not_reflected":"This validator's positive last weight is not yet reflected by the cached metagraph incentive.","chat_unauthorized":"The endpoint is reachable but /chat returns 401 to validator canaries.","chat_forbidden":"The endpoint is reachable but /chat returns 403 to validator canaries.","chat_not_found":"The endpoint is reachable but /chat route is missing.","timeout":"Recent inference/canary request timed out.","connection_failed":"Recent inference/canary request could not connect.","tls_error":"Recent inference/canary request failed TLS/certificate validation.","on_probation":"One or more endpoint entries are on probation.","capacity_audit_failures":"Recent capacity-audit failures remain in the scoring lookback.","uid_audit_gate_active":"UID-level capacity-audit floor is active.","recent_endpoint_churn":"Recent inactive/stale endpoint entries still affect interpretation.","stale_uid_identity":"An old EVM address is stale for the current UID owner.","blacklisted":"The current miner address is blacklisted by subnet configuration.","model_gate_active":"The executor fails the current model/GPU capacity gate.","proof_failure":"A recent synthetic canary proof failed verification.","tee_failure":"A recent TEE attestation failed verification.","no_active_endpoint":"No active endpoint is present for this UID."},"notes":["This endpoint is cached; it does not run live probes.","It does not expose future audit timing, raw canary prompts, or audit IDs.","Adding a new endpoint does not clear old UID-level audit failures inside the lookback.","When a UID is reassigned to another hotkey/EVM identity, prior-owner state is excluded.","Recovery estimates assume no new failures arrive before the listed epoch.","Local scores and validator weights are not the same as network incentive; metagraph values can lag or differ because weights are combined through network consensus."],"status_codes":{"200":"Cached debug data returned.","404":"Endpoint disabled, UID missing from the cache, or UID/model_index missing from the cache.","503":"Endpoint enabled but the validator has not written a debug cache yet."}}