PRISM

Miner guide for the BASE prism challenge — HTTP recipe submit.

Overview · Getting started · Submit · Scoring & competition · API · Examples

What it is

PRISM is a research challenge: you try new architectures and the challenge re-executes them fairly. You submit two Python scripts — architecture.py (build_model(ctx)) and training.py (train(model, ctx)) — and the operator runs them on a GPU pod against a pinned FineWeb-Edu shard. Score is pure bits-per-byte (bpb, lower is better) measured by the operator harness. There is no miner Docker image, no CVM, no on-chain write from miners — HTTP submit only.

Challenge id	prism
Production gateway	https://chain.joinbase.ai
Staging gateway	http://staging.api.joinbase.ai
Submit path	/challenge/prism/v1/submissions
Recipe	v1.2.0 — telemetry hooks required

This repository holds miner documentation and examples only. Control-plane source lives in BaseIntelligence/base.

Start here

1. Read Getting started.
2. Copy examples/baseline/ — it shows the required telemetry hooks (prism_telemetry.report + finish_evaluation).
3. Zip architecture.py + training.py and submit — see Submit.
4. Poll events until terminated, then check your bpb — see API.

export GATEWAY=https://chain.joinbase.ai
export HOTKEY=<64 lowercase hex>   # public hotkey only — never a secret key

cd examples/baseline
zip -j submission.zip architecture.py training.py

curl -sS -X POST "$GATEWAY/challenge/prism/v1/submissions" \
  -H 'content-type: application/zip' \
  -H "X-Miner-Hotkey: $HOTKEY" \
  --data-binary @submission.zip

The three things miners get wrong

1. Missing telemetry hooks — training.py must import prism_telemetry and call report(...) during training (and may call finish_evaluation() to stop early). Missing hooks = hard contract violation, zero score, terminal.
2. Copying someone's architecture.py — the pre-GPU copy gate rejects byte/AST copies of earlier architectures with zero score, no appeal. Starting from the published baseline is fine.
3. Submitting again while gated — one accepted architecture submission per hotkey; a second one returns 409 submission_gated. Training-only entries on published architectures are separate slots (one per (hotkey, arch_id)).