Skip to content

README.md

Latest commit

 

History

History
62 lines (42 loc) · 1.74 KB

README.md

File metadata and controls

62 lines (42 loc) · 1.74 KB
Raw

Miner guide (demand)

Demand miners browse Hypercluster marketplace offers, rent capacity, and submit multi-node (or single-node) jobs. Scores roll into raw weights for Base master emission share.

You do not need a commercial GPU broker account. Work with listed capacity or operate as a provider on nodes you already control.

Prerequisites

  • Reachable challenge URL (local, docker map, or Base proxy path)
  • Hotkey + signing material for mutating routes
  • Optional: Typer CLI via uv run hypercluster

Typical flow

  1. Probe identity
curl -fsS "$URL/health"
hypercluster health --url "$URL"
  1. Browse offers
hypercluster marketplace offers list --url "$URL"
# or GET /v1/offers
  1. Rent with transparent price/lifetime bounds
hypercluster marketplace rent --offer-id OFFER --url "$URL"
  1. Submit a HyperJob (JSON/YAML/spec path)
hypercluster jobs submit --spec job.json --url "$URL"
hypercluster jobs status --id JOB --url "$URL"
  1. Inspect scores / leaderboard
curl -fsS "$URL/v1/leaderboard"
hypercluster score show --hotkey YOUR_HOTKEY --url "$URL"
  1. Terminate lease when finished
hypercluster marketplace terminate --lease-id LEASE --url "$URL"

Tips

  • Prefer digest-pinned images and honest fabric modes matching leased capacity (ib only if the offer actually requires and provides IB).
  • Wall-clock timeouts protect the queue; efficiency scoring is compute-normalized, not pure latencies races.
  • Unsigned or incomplete auth fails closed on writes.
  • List endpoints without identity return empty private scopes rather than global dumps.

More detail: Jobs, Marketplace, Scoring, CLI.