app.py

import os
from dataclasses import dataclass
from datetime import datetime, timedelta
from enum import Enum
from zoneinfo import ZoneInfo
import bittensor as bt
import gradio as gr
from packaging import version
from substrateinterface import Keypair
from wandb.apis.importers import wandb
from wandb.apis.public import Run

WANDB_RUN_PATH = os.environ["WANDB_RUN_PATH"]

REFRESH_RATE = 30
NET_UID = 39
AVERAGE_BENCHMARK_TIME_WARNING_THRESHOLD = 300 # 5 minutes
ETA_WARNING_THRESHOLD = 43200 # 12 hours
UPDATED_WARNING_THRESHOLD = 1000
VTRUST_WARNING_THRESHOLD = 0.75

subtensor = bt.subtensor()
metagraph = bt.metagraph(netuid=NET_UID)


class BenchmarkState(Enum):
 NOT_STARTED = ("Not Started", "orange")
 IN_PROGRESS = ("In Progress", "orange")
 FINISHED = ("Finished", "springgreen")
 OUT_OF_DATE = ("Out of Date", "red")
 STOPPED = ("Stopped", "red")
 CRASHED = ("Crashed", "red")
 FAILED = ("Failed", "red")

 def get_alt_time_text(self) -> str:
 return "∞" if self.is_broken() else "N/A"

 def name(self):
 return self.value[0]

 def color(self):
 return self.value[1]

 def is_broken(self):
 return self == BenchmarkState.NOT_STARTED or self == BenchmarkState.STOPPED or self == BenchmarkState.CRASHED or self == BenchmarkState.FAILED


@dataclass
class State:
 benchmarking_state: BenchmarkState
 hotkey: str
 name: str
 version: str
 submissions: int
 benchmarks: int
 invalid: int
 average_benchmark_time: float
 vtrust: float
 updated: int


data: dict[int, State] = {}
last_refresh: datetime = datetime.fromtimestamp(0, tz=ZoneInfo("US/Pacific"))


def is_valid_run(run: Run):
 required_config_keys = ["hotkey", "uid", "contest", "signature"]

 for key in required_config_keys:
 if key not in run.config:
 return False

 validator_hotkey = run.config["hotkey"]
 contest_name = run.config["contest"]

 signing_message = f"{run.name}:{validator_hotkey}:{contest_name}"

 try:
 return Keypair(validator_hotkey).verify(signing_message, run.config["signature"])
 except Exception:
 return False


def get_identity(uid: int) -> str | None:
 identity = subtensor.substrate.query('SubtensorModule', 'Identities', [metagraph.coldkeys[uid]])
 return identity.value["name"] if identity != None else None


def fetch_wandb_data():
 wandb_api = wandb.Api()
 global data
 data.clear()

 now = datetime.now(tz=ZoneInfo("US/Pacific"))
 noon = now.replace(hour=12, minute=0, second=0, microsecond=0)
 if now.hour < 12:
 noon -= timedelta(days=1)

 wandb_runs = wandb_api.runs(
 WANDB_RUN_PATH,
 filters={"config.type": "validator", "created_at": {'$gt': str(noon)}},
 order="-created_at",
 )

 for run in wandb_runs:
 if not is_valid_run(run):
 continue

 uid = run.config["uid"]

 if uid in data:
 continue

 if not metagraph.validator_permit[uid]:
 continue

 submissions: set[int] = set()
 benchmarks: set[int] = set()
 invalid: dict[int, str] = {}
 average_benchmark_time = 0.0

 for key, value in run.summary.items():
 if key == "average_benchmark_time":
 average_benchmark_time = float(value)

 elif key == "invalid":
 invalid = dict(value)

 elif key == "submissions":
 submissions = {int(uid) for uid in value.keys()}

 elif key == "benchmarks":
 benchmarks = {int(uid) for uid in value.keys()}


 benchmarking_state: BenchmarkState
 run_state = run.state
 if run_state == "finished":
 benchmarking_state = BenchmarkState.STOPPED
 elif run_state == "crashed":
 benchmarking_state = BenchmarkState.CRASHED
 elif run_state == "failed":
 benchmarking_state = BenchmarkState.FAILED
 elif "benchmarking_state" in run.summary:
 benchmarking_state = BenchmarkState[run.summary.get("benchmarking_state")]
 else:
 benchmarking_state = BenchmarkState.OUT_OF_DATE

 for invalid_uid, reason in invalid.items():
 if not reason.startswith("Duplicate of UID"):
 benchmarks.add(invalid_uid)

 block = subtensor.get_current_block()
 data[uid] = State(
 benchmarking_state=benchmarking_state,
 hotkey=run.config["hotkey"],
 name=get_identity(uid) or run.config["hotkey"],
 version=run.tags[1][8:],
 submissions=len(submissions),
 benchmarks=len(benchmarks),
 invalid=len(invalid),
 average_benchmark_time=average_benchmark_time,
 vtrust=metagraph.validator_trust[uid],
 updated=block - metagraph.last_update[uid],
 )

 data = dict(sorted(data.items()))


def get_latest_version(data: dict[int, State]) -> str:
 latest_version = version.parse("0.0.0")
 for source_validator_uid, state in data.items():
 current_version = version.parse(state.version)
 if current_version > latest_version:
 latest_version = current_version
 return str(latest_version)


def try_refresh():
 global last_refresh
 now = datetime.now(tz=ZoneInfo("US/Pacific"))

 if (now - last_refresh).total_seconds() > REFRESH_RATE:
 print(f"Refreshing States at {now.strftime('%Y-%m-%d %H:%M:%S')}")
 metagraph.sync(subtensor=subtensor)
 fetch_wandb_data()
 last_refresh = now


def get_data() -> gr.Dataframe:
 try_refresh()

 elements: list[tuple] = []
 latest_version = get_latest_version(data)
 now = datetime.now(tz=ZoneInfo("US/Pacific"))

 for uid, state in data.items():
 eta = int(state.average_benchmark_time * (state.submissions - state.benchmarks))
 time_left = timedelta(seconds=eta)
 eta_date = now + time_left
 eta_time = eta_date.strftime("%Y-%m-%d %I:%M:%S %p") if eta > 0 and state.benchmarking_state == BenchmarkState.IN_PROGRESS else state.benchmarking_state.get_alt_time_text()

 average_time_text = f"{timedelta(seconds=int(state.average_benchmark_time))}" if state.average_benchmark_time else state.benchmarking_state.get_alt_time_text(),

 elements.append((
 uid,
 state.name,
 f"<span style='color: {'springgreen' if state.version == latest_version else 'red'}'>{state.version}</span>",
 f"<span style='color: {state.benchmarking_state.color()}'>{state.benchmarking_state.name()}</span>",
 state.benchmarks,
 state.submissions,
 state.invalid,
 f"<span style='color: {'orange' if state.average_benchmark_time > AVERAGE_BENCHMARK_TIME_WARNING_THRESHOLD else 'springgreen'}'>{average_time_text[0]}</span>",
 f"<span style='color: {'orange' if eta > ETA_WARNING_THRESHOLD else 'springgreen'}'>{eta_time}</span>",
 f"<span style='color: {'orange' if eta > ETA_WARNING_THRESHOLD else 'springgreen'}'>{time_left if eta > 0 and state.benchmarking_state == BenchmarkState.IN_PROGRESS else state.benchmarking_state.get_alt_time_text()}</span>",
 f"<span style='color: {'springgreen' if state.vtrust > VTRUST_WARNING_THRESHOLD else 'red'}'>{state.vtrust:.4f}</span>",
 f"<span style='color: {'springgreen' if state.updated < UPDATED_WARNING_THRESHOLD else 'red'}'>{state.updated}</span>",
 ))

 return gr.Dataframe(
 elements,
 headers=["UID", "Name", "Version", "Status", "Tested", "Submissions", "Invalid", "Avg. Benchmark Time", "ETA (Pacific Time)", "ETA Remaining", "VTrust", "Updated"],
 datatype=["number", "markdown", "markdown", "markdown", "number", "number", "number", "markdown", "markdown", "markdown", "markdown", "markdown"],
 label=f"SN{NET_UID} Validator States (Last updated: {last_refresh.strftime('%Y-%m-%d %I:%M:%S %p')} PST)",
 interactive=False,
 )


def main():
 with gr.Blocks(css=".typewriter {font-family: 'JMH Typewriter', sans-serif;}", fill_height=True, fill_width=True) as demo:
 table = gr.Dataframe()
 table.attach_load_event(lambda: get_data(), None)
 demo.launch()


if __name__ == '__main__':
 main()