41 lines (29 loc) · 1.09 KB

Cloudflare Worker

Gateway/API layer for proof jobs, claim submission, and leaderboard services.

Responsibilities

Receives proof job submissions from clients.
Validates tapes and enqueues work (PROOF_QUEUE, VAST_QUEUE).
Coordinates job lifecycle via ProofCoordinatorDO.
Stores artifacts in R2 and leaderboard data in D1.
Exposes leaderboard profile/auth endpoints.

Entry Points

worker/index.ts: router wiring, queue handlers, cron jobs.
worker/api/routes.ts: proof/seed/relay API routes.
worker/api/leaderboard-routes.ts: leaderboard and profile APIs.
worker/queue/consumer.ts: queue consumer orchestration.
worker/durable/coordinator.ts: durable job state.

API Surfaces

/api/health
/api/seed/current, /api/seed/refresh
/api/proofs/jobs (+ status/list/delete/retry endpoints)
/api/relay
/api/leaderboard/* (public and profile routes)

Configuration

Bindings and env interface are defined in worker/env.ts and configured via wrangler.jsonc.

Verification

From repo root:

bun run typecheck:worker
bun test tests/worker