@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/api/launcher-endpoints.js

@@ -0,0 +1,50 @@
+import { gatherLauncherStatus, } from './launcher-status.js';
+import { gatherLauncherTasks, } from './launcher-tasks.js';
+const MIN_LIMIT = 1;
+const MAX_LIMIT = 100;
+const DEFAULT_LIMIT = 25;
+const CURSOR_PREFIX = 'before:';
+function parseLimit(raw) {
+    if (raw === undefined)
+        return DEFAULT_LIMIT;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        return DEFAULT_LIMIT;
+    return Math.min(MAX_LIMIT, Math.max(MIN_LIMIT, Math.floor(parsed)));
+}
+function parseCursor(raw) {
+    if (!raw)
+        return undefined;
+    if (raw.startsWith(CURSOR_PREFIX))
+        return raw.slice(CURSOR_PREFIX.length);
+    // Be permissive: a bare ISO timestamp is treated as `before:<iso>` so the
+    // SPA can pass either form without a wrapper layer.
+    return raw;
+}
+export function addLauncherRoutes(app, deps) {
+    app.get('/v1/launcher/status', async (c) => {
+        const body = await gatherLauncherStatus({ ...deps, config: deps.getConfig() });
+        return c.json(body);
+    });
+    app.get('/v1/launcher/tasks', async (c) => {
+        const limit = parseLimit(c.req.query('limit'));
+        const before = parseCursor(c.req.query('cursor'));
+        const body = await gatherLauncherTasks({ ...deps.tasksDeps, config: deps.getConfig() }, { limit, ...(before ? { before } : {}) });
+        return c.json(body);
+    });
+    // Legacy launcher-mode SolverNet patch (`PATCH /v1/launcher/solvernets/:name`)
+    // was retired by Task 22 of spec/2026-05-05-solvernet-creation-and-launch.md
+    // — the operator-config `'launching'` role + top-level `predictionV1*`
+    // generator-config keys it managed have been removed from the schema.
+    // Launched-record-driven launcher SolverNet edits now flow through the
+    // launched-record subsystem (see solvernets-endpoints.ts / Task 14). The
+    // route returns 410 Gone so SPA clients on stale builds get a clear
+    // signal rather than a silently-succeeding write to dropped fields.
+    app.patch('/v1/launcher/solvernets/:name', async (c) => {
+        return c.json({
+            error: 'gone',
+            message: "PATCH /v1/launcher/solvernets/:name is retired — operator-config 'launching' role and predictionV1* keys were removed by Task 22 of spec/2026-05-05-solvernet-creation-and-launch.md. Use the launched-record SolverNet endpoints instead.",
+        }, 410);
+    });
+}
+//# sourceMappingURL=launcher-endpoints.js.map

package/dist/api/launcher-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-endpoints.js","sourceRoot":"","sources":["../../src/api/launcher-endpoints.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,oBAAoB,GAErB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC;AA+B7B,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC,SAAS,UAAU,CAAC,GAAuB;IACzC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,aAAa,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,WAAW,CAAC,GAAuB;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1E,0EAA0E;IAC1E,oDAAoD;IACpD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAS,EAAE,IAAwB;IACnE,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,mBAAmB,CACpC,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAC/C,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACzC,CAAC;QACF,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,+EAA+E;IAC/E,6EAA6E;IAC7E,uEAAuE;IACvE,sEAAsE;IACtE,uEAAuE;IACvE,yEAAyE;IACzE,oEAAoE;IACpE,oEAAoE;IACpE,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACrD,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE,MAAM;YACb,OAAO,EACL,4OAA4O;SAC/O,EACD,GAAG,CACJ,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/launcher-status.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Launcher mode status assembler.
+ *
+ * Composes per-SolverNet generator state, open-Task counts, and Safe budget
+ * runway into the canonical `LauncherStatusResponse`. Surfaces every
+ * SolverNet entry the daemon has loaded — launcher ownership is no longer
+ * expressed via an operator-config `'launching'` role (Task 22 of
+ * spec/2026-05-05-solvernet-creation-and-launch.md dropped that enum value);
+ * the launched-record subsystem owns that signal now.
+ *
+ * Stale-poll detection is computed here from the generator's reported
+ * `lastPollAt` and `cadenceMs`: a poll is stale when the wall clock has
+ * advanced past `lastPollAt + 2 * cadenceMs`. The 2× factor matches
+ * spec/2026-05-05-launcher-role-and-mode.md §5.3.
+ *
+ * The deps shape is intentionally narrow — every external surface is a
+ * function so tests can inject deterministic state without standing up the
+ * full daemon. Subdeps that require deeper integration (open-Task counts,
+ * reserved-budget math, Safe-balance reads) are abstract here; v1 wires them
+ * to placeholder accessors with TODO pointers at Task 7.
+ */
+import type { JinnConfig } from '../config.js';
+export interface LauncherStatusGeneratorView {
+    state: 'active' | 'paused' | 'errored';
+    lastPollAt?: string;
+    lastPollSummary?: {
+        evaluated: number;
+        posted: number;
+        skipped: number;
+    };
+    lastError?: {
+        message: string;
+        at: string;
+    };
+    cadenceMs: number;
+    stale: boolean;
+}
+export interface LauncherStatusBudgetView {
+    safeAddress: string;
+    safeBalanceWei: string;
+    reservedBudgetWei: string;
+    runwayDays?: number;
+}
+export interface LauncherStatusNetEntry {
+    name: string;
+    solverType?: string;
+    generator: LauncherStatusGeneratorView;
+    openTasks: number;
+    budget: LauncherStatusBudgetView;
+}
+export interface LauncherStatusResponse {
+    schemaVersion: 1;
+    generatedAt: string;
+    nets: LauncherStatusNetEntry[];
+}
+/**
+ * Generator state snapshot the gather function consumes. Matches
+ * `PredictionV1GeneratorStateSnapshot` in shape but is declared here so the
+ * gather function does not depend on a specific SolverType module.
+ */
+export interface LauncherGeneratorStateSnapshot {
+    lastPollAt?: string;
+    lastPollSummary?: {
+        evaluated: number;
+        posted: number;
+        skipped: number;
+    };
+    lastError?: {
+        message: string;
+        at: string;
+    };
+    cadenceMs: number;
+}
+export interface GatherLauncherStatusDeps {
+    config: Pick<JinnConfig, 'solverNets'>;
+    /** Returns the generator's live state, or `undefined` if the SolverNet has no generator. */
+    getGeneratorState: (netName: string) => LauncherGeneratorStateSnapshot | undefined;
+    /** Count of Tasks created by the operator that are still in flight for the named SolverNet. */
+    getOpenTaskCount: (netName: string) => Promise<number> | number;
+    /** Sum of unconsumed claim payments across open Tasks (wei string). */
+    getReservedBudgetWei: (netName: string) => Promise<string> | string;
+    /** Safe ETH balance in wei (string) for the operator's funding wallet. */
+    getSafeBalanceWei: () => Promise<string> | string;
+    /**
+     * Operator Safe address used for budget views. Either a literal string (when
+     * known at construction time, e.g. tests) or a getter (when the address only
+     * resolves after bootstrap completes — see main.ts wiring).
+     */
+    safeAddress: string | (() => string);
+    /** Now-source override for deterministic tests. */
+    now?: () => number;
+}
+export declare function gatherLauncherStatus(deps: GatherLauncherStatusDeps): Promise<LauncherStatusResponse>;

package/dist/api/launcher-status.js

@@ -0,0 +1,84 @@
+/**
+ * Derive the high-level generator state. `errored` wins over `active`/`paused`
+ * because the operator wants to see the failure first; `paused` only fires
+ * when no generator state is exposed at all (closed role gate before the very
+ * first tick, or a SolverNet without a launcher implementation).
+ *
+ * NOTE (v1 edge case, jinn-mono-l2zl carry-over from Task 6 review): a
+ * generator with a `cadenceMs > 0` and no `lastError` reports `active` even
+ * before its first poll has completed. If the daemon has been running long
+ * enough that the first poll *should* have completed but `lastPollAt` is
+ * still undefined, the operator UI will show "active, not stale" — which is
+ * misleading. The fix requires tracking a `genStartedAt` timestamp on the
+ * generator so the gather function can compare `now - genStartedAt`
+ * against `2 * cadenceMs`. Deferred to a follow-up: in v1 the prediction.v1
+ * cadence is 6h, so the window between "started" and "first tick" is short
+ * enough that the misclassification is rare in practice. Tracked under
+ * the launcher-mode plan (spec/2026-05-05-launcher-role-and-mode.md §5.3).
+ */
+function deriveGeneratorState(snapshot) {
+    if (!snapshot)
+        return 'paused';
+    if (snapshot.lastError)
+        return 'errored';
+    return 'active';
+}
+function isStalePoll(snapshot, now) {
+    if (!snapshot || !snapshot.lastPollAt)
+        return false;
+    const lastPollMs = Date.parse(snapshot.lastPollAt);
+    if (!Number.isFinite(lastPollMs))
+        return false;
+    const cadenceMs = snapshot.cadenceMs ?? 0;
+    if (cadenceMs <= 0)
+        return false;
+    return now - lastPollMs > 2 * cadenceMs;
+}
+export async function gatherLauncherStatus(deps) {
+    const now = deps.now?.() ?? Date.now();
+    const nets = [];
+    for (const [name, net] of Object.entries(deps.config.solverNets ?? {})) {
+        // Task 22 of spec/2026-05-05-solvernet-creation-and-launch.md removed
+        // the operator-config `'launching'` role; surface every loaded SolverNet
+        // entry. Launched-record ownership filters happen at the launched-record
+        // surface, not here.
+        const snapshot = deps.getGeneratorState(name);
+        const generatorState = deriveGeneratorState(snapshot);
+        const stale = isStalePoll(snapshot, now);
+        const [openTasks, reservedBudgetWei, safeBalanceWei] = await Promise.all([
+            Promise.resolve(deps.getOpenTaskCount(name)),
+            Promise.resolve(deps.getReservedBudgetWei(name)),
+            Promise.resolve(deps.getSafeBalanceWei()),
+        ]);
+        const generator = {
+            state: generatorState,
+            cadenceMs: snapshot?.cadenceMs ?? 0,
+            stale,
+        };
+        if (snapshot?.lastPollAt)
+            generator.lastPollAt = snapshot.lastPollAt;
+        if (snapshot?.lastPollSummary)
+            generator.lastPollSummary = { ...snapshot.lastPollSummary };
+        if (snapshot?.lastError)
+            generator.lastError = { ...snapshot.lastError };
+        const safeAddress = typeof deps.safeAddress === 'function' ? deps.safeAddress() : deps.safeAddress;
+        const solverType = net?.solverType;
+        nets.push({
+            name,
+            ...(typeof solverType === 'string' && solverType.length > 0 ? { solverType } : {}),
+            generator,
+            openTasks,
+            budget: {
+                safeAddress,
+                safeBalanceWei,
+                reservedBudgetWei,
+            },
+        });
+    }
+    return {
+        schemaVersion: 1,
+        generatedAt: new Date(now).toISOString(),
+        nets,
+    };
+}
+//# sourceMappingURL=launcher-status.js.map

package/dist/api/launcher-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-status.js","sourceRoot":"","sources":["../../src/api/launcher-status.ts"],"names":[],"mappings":"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"}

package/dist/api/launcher-tasks.d.ts

@@ -0,0 +1,76 @@
+import type { JinnConfig } from '../config.js';
+export type LauncherTaskState = 'open' | 'claims-in-flight' | 'fully-claimed' | 'settled' | 'failed';
+export interface LauncherTaskEntry {
+    taskId: string;
+    taskCid: string;
+    solverNet: string;
+    solverType?: string;
+    postedAt: string;
+    state: LauncherTaskState;
+    claims: {
+        current: number;
+        max: number;
+    };
+    budget: {
+        totalWei: string;
+        remainingWei: string;
+        reclaimableAt?: string;
+    };
+    summary?: {
+        title?: string;
+        resolutionTime?: string;
+    };
+}
+export interface LauncherTasksResponse {
+    schemaVersion: 1;
+    generatedAt: string;
+    cursor?: {
+        before: string;
+    };
+    tasks: LauncherTaskEntry[];
+}
+/** A single posted-Task row as surfaced by the daemon's store accessor. */
+export interface PostedTaskRecord {
+    taskId: string;
+    taskCid: string;
+    /** Optional — if present, used to derive `solverNet` via config lookup. */
+    solverType?: string;
+    /** Optional override; when set, takes precedence over solverType-based mapping. */
+    solverNet?: string;
+    /** ISO-8601 timestamp; the response sorts on this DESC. */
+    postedAt: string;
+    state?: LauncherTaskState;
+    claims?: {
+        current?: number;
+        max?: number;
+    };
+    budget?: {
+        totalWei?: string;
+        remainingWei?: string;
+        reclaimableAt?: string;
+    };
+    summary?: {
+        title?: string;
+        resolutionTime?: string;
+    };
+}
+export interface FetchPostedTasksOptions {
+    creatorAddress: string;
+    /** Inclusive upper bound on result count after deps applies its own page logic. */
+    limit: number;
+    /** ISO-8601 timestamp; filter to rows with `postedAt < before`. */
+    before?: string;
+}
+export interface GatherLauncherTasksDeps {
+    config: Pick<JinnConfig, 'solverNets'>;
+    creatorAddress: string;
+    fetchPostedTasks: (opts: FetchPostedTasksOptions) => Promise<PostedTaskRecord[]> | PostedTaskRecord[];
+    now?: () => number;
+}
+export interface GatherLauncherTasksOptions {
+    /** Page size; clamped to [1, 100]. Default 25 (matches spec). */
+    limit?: number;
+    /** ISO-8601 timestamp; filter to rows with `postedAt < before`. */
+    before?: string;
+}
+export declare function gatherLauncherTasks(deps: GatherLauncherTasksDeps, opts?: GatherLauncherTasksOptions): Promise<LauncherTasksResponse>;

package/dist/api/launcher-tasks.js

@@ -0,0 +1,127 @@
+/**
+ * Launcher-mode posted-Tasks query. Returns the canonical
+ * `LauncherTasksResponse` for `GET /v1/launcher/tasks` — the SPA's
+ * PostedTasksList consumes this directly.
+ *
+ * Pagination: `before` cursor is an ISO timestamp; results are returned in
+ * `postedAt DESC` order. When the page fills (`tasks.length === limit`) the
+ * response includes a `cursor.before` set to the oldest entry's `postedAt`
+ * so the next call can resume.
+ *
+ * What is and isn't sourced today (Task 7 of
+ * spec/2026-05-05-launcher-role-and-mode.md):
+ *   ✓ taskId / taskCid / postedAt — from `task_posts` + `activity_events`
+ *   ✓ solverNet — derived by mapping the `task_posted` event's `solver_type`
+ *     back to the SolverNet name in config (the only solver-type → net mapping
+ *     in v1 is 1:1, so the lookup is straightforward).
+ *   ✓ state / claims.current / claims.max — sourced from local task_posts and
+ *     matching task_runs when available. This is a pragmatic local projection,
+ *     not a full chain index; unresolved fields still use explicit unavailable
+ *     fallbacks.
+ *   ✗ budget.remainingWei — requires on-chain accounting that the v1 daemon
+ *     does not yet maintain.
+ *   ✗ summary.title / summary.resolutionTime — would require persisting the
+ *     full Task spec at post-time. Out of scope for v1; the SPA falls back
+ *     to taskId/postedAt when summary is absent.
+ *
+ * Spec: spec/2026-05-05-launcher-role-and-mode.md §5.3.
+ */
+import { getSolverNetContract } from '../vendor/@jinn-network/sdk/dist/solvernets/index.js';
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 100;
+const CLAIMS_CURRENT_UNAVAILABLE_FALLBACK = 0;
+const CLAIMS_MAX_UNAVAILABLE_FALLBACK = 25;
+function claimMaxFallbackForSolverType(solverType) {
+    if (!solverType)
+        return CLAIMS_MAX_UNAVAILABLE_FALLBACK;
+    const splitAt = solverType.lastIndexOf('.');
+    if (splitAt <= 0 || splitAt === solverType.length - 1) {
+        return CLAIMS_MAX_UNAVAILABLE_FALLBACK;
+    }
+    const contract = getSolverNetContract({
+        id: solverType.slice(0, splitAt),
+        version: solverType.slice(splitAt + 1),
+    });
+    return contract?.claimPolicyDefaults?.maxClaims ?? CLAIMS_MAX_UNAVAILABLE_FALLBACK;
+}
+/**
+ * Build a solverType → solverNet-name lookup from the live config. The v1
+ * mapping is 1:1 (one SolverNet per solver-type), but we index defensively so
+ * a future fork-of-prediction config doesn't silently mislabel posted Tasks.
+ */
+function buildSolverTypeToNetIndex(solverNets) {
+    const index = new Map();
+    if (!solverNets)
+        return index;
+    for (const [name, net] of Object.entries(solverNets)) {
+        const solverType = net?.solverType;
+        if (typeof solverType === 'string' && solverType.length > 0 && !index.has(solverType)) {
+            index.set(solverType, name);
+        }
+    }
+    return index;
+}
+function mapRecordToEntry(record, solverTypeIndex) {
+    const solverNet = record.solverNet
+        ?? (record.solverType ? solverTypeIndex.get(record.solverType) : undefined)
+        ?? 'unknown';
+    const claimsCurrent = record.claims?.current ?? CLAIMS_CURRENT_UNAVAILABLE_FALLBACK;
+    const claimsMax = record.claims?.max ?? claimMaxFallbackForSolverType(record.solverType);
+    const totalWei = record.budget?.totalWei ?? '0';
+    const remainingWei = record.budget?.remainingWei ?? totalWei;
+    const entry = {
+        taskId: record.taskId,
+        taskCid: record.taskCid,
+        solverNet,
+        ...(record.solverType ? { solverType: record.solverType } : {}),
+        postedAt: record.postedAt,
+        state: record.state ?? 'open',
+        claims: { current: claimsCurrent, max: claimsMax },
+        budget: { totalWei, remainingWei },
+    };
+    if (record.budget?.reclaimableAt) {
+        entry.budget.reclaimableAt = record.budget.reclaimableAt;
+    }
+    if (record.summary) {
+        entry.summary = { ...record.summary };
+    }
+    return entry;
+}
+export async function gatherLauncherTasks(deps, opts = {}) {
+    const requested = opts.limit ?? DEFAULT_LIMIT;
+    const limit = Math.min(MAX_LIMIT, Math.max(1, Math.floor(requested)));
+    const fetched = await Promise.resolve(deps.fetchPostedTasks({
+        creatorAddress: deps.creatorAddress,
+        limit,
+        before: opts.before,
+    }));
+    // Defensive sort: the store accessor returns rows in DESC `postedAt`
+    // order, but the gather function is also reachable from tests that pass
+    // unsorted fixtures. Sort here so the response invariant is unconditional.
+    const sorted = [...fetched].sort((a, b) => {
+        const ta = Date.parse(a.postedAt);
+        const tb = Date.parse(b.postedAt);
+        if (Number.isFinite(ta) && Number.isFinite(tb))
+            return tb - ta;
+        if (Number.isFinite(ta))
+            return -1;
+        if (Number.isFinite(tb))
+            return 1;
+        return 0;
+    });
+    const solverTypeIndex = buildSolverTypeToNetIndex(deps.config.solverNets);
+    const tasks = sorted.slice(0, limit).map((record) => mapRecordToEntry(record, solverTypeIndex));
+    const cursor = tasks.length === limit && tasks.length > 0
+        ? { before: tasks[tasks.length - 1].postedAt }
+        : undefined;
+    const generatedAtMs = deps.now?.() ?? Date.now();
+    const response = {
+        schemaVersion: 1,
+        generatedAt: new Date(generatedAtMs).toISOString(),
+        tasks,
+    };
+    if (cursor)
+        response.cursor = cursor;
+    return response;
+}
+//# sourceMappingURL=launcher-tasks.js.map

package/dist/api/launcher-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-tasks.js","sourceRoot":"","sources":["../../src/api/launcher-tasks.ts"],"names":[],"mappings":"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"}

package/dist/api/leaderboard-api.d.ts

@@ -0,0 +1,20 @@
+import { Hono } from 'hono';
+export interface LeaderboardDeps {
+    querySubgraph(mode: 'train' | 'frozen'): Promise<{
+        harnessRollups: Array<{
+            implName: string;
+            codeDigest: string;
+            mode: 'train' | 'frozen';
+            verdictCount: number;
+            scoreSum: number;
+            uniqueOperators: number;
+            lastSeenAt: number;
+            meanResolved?: number;
+        }>;
+    }>;
+    isCheckpointVerified(args: {
+        implName: string;
+        codeDigest: string;
+    }): Promise<boolean>;
+}
+export declare function leaderboardRoutes(deps: LeaderboardDeps): Hono;

package/dist/api/leaderboard-api.js

@@ -0,0 +1,18 @@
+import { Hono } from 'hono';
+export function leaderboardRoutes(deps) {
+    const app = new Hono();
+    app.get('/api/solvernets/:name/leaderboard', async (c) => {
+        const mode = (c.req.query('mode') ?? 'train');
+        const result = await deps.querySubgraph(mode);
+        const rollups = await Promise.all(result.harnessRollups.map(async (r) => ({
+            ...r,
+            meanResolved: r.verdictCount > 0 ? r.scoreSum / r.verdictCount : 0,
+            verified: mode === 'frozen'
+                ? await deps.isCheckpointVerified({ implName: r.implName, codeDigest: r.codeDigest })
+                : null,
+        })));
+        return c.json({ rollups });
+    });
+    return app;
+}
+//# sourceMappingURL=leaderboard-api.js.map

package/dist/api/leaderboard-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-api.js","sourceRoot":"","sources":["../../src/api/leaderboard-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkB5B,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,GAAG,CAAC,mCAAmC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACvD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO,CAAuB,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,GAAG,CAAC;YACJ,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAClE,QAAQ,EACN,IAAI,KAAK,QAAQ;gBACf,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;gBACrF,CAAC,CAAC,IAAI;SACX,CAAC,CAAC,CACJ,CAAC;QACF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/api/operator-artifacts-endpoint.d.ts

@@ -0,0 +1,19 @@
+import type { Hono } from 'hono';
+import { persistTopLevelConfigValue } from '../config.js';
+import type { Store } from '../store/store.js';
+export interface OperatorPricingConfig {
+    publicEndpoint: string;
+    defaultPriceUsdc: string;
+    perArtifactTypePrice: Record<string, string>;
+    donation: {
+        enabled: boolean;
+    };
+}
+export interface OperatorArtifactsRoutesConfig {
+    store: Store;
+    configPath?: string;
+    operatorConfig?: OperatorPricingConfig;
+    persistConfigValue?: typeof persistTopLevelConfigValue;
+    onOperatorConfigUpdated?: (operator: OperatorPricingConfig) => void;
+}
+export declare function addOperatorArtifactsRoutes(app: Hono, config: OperatorArtifactsRoutesConfig): void;