@jinn-network/client 0.1.1 → 0.1.2-canary.d6e72dfd

package/dist/restorer/impls/prediction-v0-baseline/strategy.js

@@ -0,0 +1,41 @@
+/** Decimal comparison. Both inputs are non-negative decimal strings. */
+function decCmp(a, b) {
+    const [ai, af = ''] = a.split('.');
+    const [bi, bf = ''] = b.split('.');
+    const aiN = ai.replace(/^0+/, '') || '0';
+    const biN = bi.replace(/^0+/, '') || '0';
+    if (aiN.length !== biN.length)
+        return aiN.length - biN.length;
+    if (aiN !== biN)
+        return aiN < biN ? -1 : 1;
+    const maxLen = Math.max(af.length, bf.length);
+    const afP = af.padEnd(maxLen, '0');
+    const bfP = bf.padEnd(maxLen, '0');
+    if (afP === bfP)
+        return 0;
+    return afP < bfP ? -1 : 1;
+}
+function evaluateQuestion(question, price) {
+    if (question.kind === 'threshold') {
+        const c = decCmp(price, question.threshold);
+        switch (question.operator) {
+            case 'GT': return c > 0;
+            case 'GTE': return c >= 0;
+            case 'LT': return c < 0;
+            case 'LTE': return c <= 0;
+        }
+    }
+    else {
+        const lowerCmp = decCmp(price, question.lowerBound);
+        const upperCmp = decCmp(price, question.upperBound);
+        return lowerCmp >= 0 && upperCmp < 0;
+    }
+}
+export function spotCarryPredict(intent, currentPrice) {
+    const currentlyYes = evaluateQuestion(intent.spec.question, currentPrice);
+    return {
+        probability: currentlyYes ? '0.55' : '0.45',
+        modelId: 'spot-carry.v1',
+    };
+}
+//# sourceMappingURL=strategy.js.map

package/dist/restorer/impls/prediction-v0-baseline/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-baseline/strategy.ts"],"names":[],"mappings":"AAQA,wEAAwE;AACxE,SAAS,MAAM,CAAC,CAAS,EAAE,CAAS;IAClC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACzC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACzC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC9D,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgD,EAAE,KAAa;IACvF,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5C,QAAQ,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC1B,KAAK,IAAI,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,KAAK,IAAI,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B,EAAE,YAAoB;IAC/E,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC1E,OAAO;QACL,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC3C,OAAO,EAAE,eAAe;KACzB,CAAC;AACJ,CAAC"}

package/dist/restorer/impls/prediction-v0-baseline/types.d.ts

@@ -0,0 +1,7 @@
+export interface StrategyPrediction {
+    probability: string;
+    modelId: string;
+}
+export interface Strategy {
+    predict(intent: import('../../../types/prediction.js').PredictionV0Intent, currentPrice: string): StrategyPrediction;
+}

package/dist/restorer/impls/prediction-v0-baseline/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/restorer/impls/prediction-v0-baseline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-baseline/types.ts"],"names":[],"mappings":""}

package/dist/restorer/impls/prediction-v0-evaluator/canonical-metrics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canonical metrics for prediction.v0 evaluator.
+ *
+ * §6 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ */
+import type { PredictionV0Intent } from '../../../types/prediction.js';
+/** Compare two non-negative decimal strings. Returns negative/zero/positive. */
+export declare function decCmp(a: string, b: string): number;
+export type GroundTruth = 'YES' | 'NO';
+export declare function resolveGroundTruth(question: PredictionV0Intent['spec']['question'], price: string): GroundTruth;
+/**
+ * Brier score scaled to 1e18 fixed-point.
+ *
+ * score = 1 - (probability - outcome)^2 ∈ [0,1]
+ *   * probability: decimal string ∈ [0,1]
+ *   * outcome: 0 | 1
+ *
+ * Returns: string representation of BigInt (score × 1e18), rounded to nearest.
+ */
+export declare function brierScore(probability: string, outcome: 0 | 1): string;

package/dist/restorer/impls/prediction-v0-evaluator/canonical-metrics.js

@@ -0,0 +1,66 @@
+/** Compare two non-negative decimal strings. Returns negative/zero/positive. */
+export function decCmp(a, b) {
+    const [ai, af = ''] = a.split('.');
+    const [bi, bf = ''] = b.split('.');
+    const aiN = (ai || '0').replace(/^0+/, '') || '0';
+    const biN = (bi || '0').replace(/^0+/, '') || '0';
+    if (aiN.length !== biN.length)
+        return aiN.length - biN.length;
+    if (aiN !== biN)
+        return aiN < biN ? -1 : 1;
+    const maxLen = Math.max(af.length, bf.length);
+    const afP = af.padEnd(maxLen, '0');
+    const bfP = bf.padEnd(maxLen, '0');
+    if (afP === bfP)
+        return 0;
+    return afP < bfP ? -1 : 1;
+}
+export function resolveGroundTruth(question, price) {
+    if (question.kind === 'threshold') {
+        const c = decCmp(price, question.threshold);
+        switch (question.operator) {
+            case 'GT': return c > 0 ? 'YES' : 'NO';
+            case 'GTE': return c >= 0 ? 'YES' : 'NO';
+            case 'LT': return c < 0 ? 'YES' : 'NO';
+            case 'LTE': return c <= 0 ? 'YES' : 'NO';
+        }
+    }
+    const lo = decCmp(price, question.lowerBound);
+    const hi = decCmp(price, question.upperBound);
+    return (lo >= 0 && hi < 0) ? 'YES' : 'NO';
+}
+/**
+ * Brier score scaled to 1e18 fixed-point.
+ *
+ * score = 1 - (probability - outcome)^2 ∈ [0,1]
+ *   * probability: decimal string ∈ [0,1]
+ *   * outcome: 0 | 1
+ *
+ * Returns: string representation of BigInt (score × 1e18), rounded to nearest.
+ */
+export function brierScore(probability, outcome) {
+    const p = Number(probability);
+    if (!Number.isFinite(p) || p < 0 || p > 1) {
+        throw new Error(`brierScore: probability must be in [0,1], got ${probability}`);
+    }
+    // Use integer arithmetic to avoid floating-point precision loss.
+    // Represent probability as a rational n/d where d = 10^decimalPlaces.
+    const dotIdx = probability.indexOf('.');
+    const decimals = dotIdx === -1 ? 0 : probability.length - dotIdx - 1;
+    const d = BigInt(10 ** decimals);
+    const n = BigInt(probability.replace('.', '')); // numerator: p = n/d
+    // outcome as BigInt
+    const o = BigInt(outcome); // 0 or 1
+    // score = 1 - (p - outcome)^2
+    //       = 1 - ((n - o*d) / d)^2
+    //       = (d^2 - (n - o*d)^2) / d^2
+    const diff = n - o * d; // (p - outcome) * d
+    const scoreNum = d * d - diff * diff; // score * d^2
+    const scoreDenom = d * d;
+    // scale to 1e18: result = scoreNum * 1e18 / scoreDenom (rounded to nearest)
+    const SCALE = BigInt('1000000000000000000'); // 1e18
+    // Round: (scoreNum * SCALE + scoreDenom/2) / scoreDenom
+    const scaled = (scoreNum * SCALE + scoreDenom / 2n) / scoreDenom;
+    return scaled.toString();
+}
+//# sourceMappingURL=canonical-metrics.js.map

package/dist/restorer/impls/prediction-v0-evaluator/canonical-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-metrics.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-evaluator/canonical-metrics.ts"],"names":[],"mappings":"AAOA,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS;IACzC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAClD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC9D,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAID,MAAM,UAAU,kBAAkB,CAChC,QAAgD,EAChD,KAAa;IAEb,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5C,QAAQ,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC1B,KAAK,IAAI,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACxC,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACzC,KAAK,IAAI,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACxC,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,OAAc;IAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,iDAAiD,WAAW,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,iEAAiE;IACjE,sEAAsE;IACtE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;IACrE,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,qBAAqB;IACrE,oBAAoB;IACpB,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;IACpC,8BAA8B;IAC9B,gCAAgC;IAChC,oCAAoC;IACpC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAW,oBAAoB;IACtD,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,cAAc;IACpD,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,4EAA4E;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO;IACpD,wDAAwD;IACxD,MAAM,MAAM,GAAG,CAAC,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC;IACjE,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/restorer/impls/prediction-v0-evaluator/checks/availability.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Availability checks for prediction.v0.
+ *
+ * §6.7 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ */
+import type { Check } from '../types.js';
+import type { SpanningResult } from '../../../../venues/chainlink/client.js';
+export declare function checkOracleReachable<T>(fetch: () => Promise<T>): Promise<Check>;
+export declare function checkOracleRoundCoversResolveTs(result: Pick<SpanningResult, 'spanning'>): Check;

package/dist/restorer/impls/prediction-v0-evaluator/checks/availability.js

@@ -0,0 +1,23 @@
+export async function checkOracleReachable(fetch) {
+    try {
+        await fetch();
+        return { name: 'availability.oracle_reachable', status: 'PASS' };
+    }
+    catch (err) {
+        return {
+            name: 'availability.oracle_reachable',
+            status: 'FAIL',
+            detail: { message: err instanceof Error ? err.message : String(err) },
+        };
+    }
+}
+export function checkOracleRoundCoversResolveTs(result) {
+    return {
+        name: 'availability.oracle_round_covers_resolve_ts',
+        status: result.spanning ? 'PASS' : 'SKIP',
+        detail: result.spanning
+            ? undefined
+            : 'No Chainlink round with updatedAt > resolveTs yet; retry later.',
+    };
+}
+//# sourceMappingURL=availability.js.map

package/dist/restorer/impls/prediction-v0-evaluator/checks/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/prediction-v0-evaluator/checks/availability.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,KAAK,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,+BAA+B;YACrC,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAAwC;IAExC,OAAO;QACL,IAAI,EAAE,6CAA6C;QACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACzC,MAAM,EAAE,MAAM,CAAC,QAAQ;YACrB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,iEAAiE;KACtE,CAAC;AACJ,CAAC"}

package/dist/restorer/impls/prediction-v0-evaluator/checks/eligibility.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+import type { Window } from '../../../../types/desired-state.js';
+export declare function checkSubmissionWithinWindow(submittedAt: number, window: Window): Check;

package/dist/restorer/impls/prediction-v0-evaluator/checks/eligibility.js

@@ -0,0 +1,13 @@
+export function checkSubmissionWithinWindow(submittedAt, window) {
+    const within = submittedAt >= window.startTs && submittedAt <= window.endTs;
+    return {
+        name: 'eligibility.submission_within_window',
+        status: within ? 'PASS' : 'FAIL',
+        detail: within ? undefined : {
+            submittedAt,
+            startTs: window.startTs,
+            endTs: window.endTs,
+        },
+    };
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/restorer/impls/prediction-v0-evaluator/checks/eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/prediction-v0-evaluator/checks/eligibility.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,2BAA2B,CACzC,WAAmB,EACnB,MAAc;IAEd,MAAM,MAAM,GAAG,WAAW,IAAI,MAAM,CAAC,OAAO,IAAI,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC;IAC5E,OAAO;QACL,IAAI,EAAE,sCAAsC;QAC5C,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAChC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC3B,WAAW;YACX,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB;KACF,CAAC;AACJ,CAAC"}

package/dist/restorer/impls/prediction-v0-evaluator/checks/integrity.d.ts

@@ -0,0 +1,7 @@
+import type { Check } from '../types.js';
+import type { PredictionV0Intent, PredictionSubmissionManifest } from '../../../../types/prediction.js';
+export declare function checkWindowBounds(intent: PredictionV0Intent): Check;
+export declare function checkManifestFieldsPresent(prediction: PredictionSubmissionManifest['prediction']): Check;
+export declare function checkManifestSignature(canonicalHash: `0x${string}`, signature: PredictionSubmissionManifest['signature']): Promise<Check>;
+/** Verify the restorer's claimed intent CID matches the on-chain request. */
+export declare function checkIntentRef(manifestIntentCid: string, expectedIntentCid: string): Check;

package/dist/restorer/impls/prediction-v0-evaluator/checks/integrity.js

@@ -0,0 +1,93 @@
+import { recoverAddress } from 'viem';
+/**
+ * Window-bounds integrity. We no longer pin an exact duration — the schema
+ * enforces sane min/max bounds (1min ≤ window ≤ 24h; 0 ≤ resolveGap ≤ 1h),
+ * so this check just re-verifies those invariants at eval time in case the
+ * manifest was built against an older schema version.
+ */
+const MIN_WINDOW_MS = 60_000;
+const MAX_WINDOW_MS = 86_400_000;
+const MAX_RESOLVE_GAP_MS = 3_600_000;
+export function checkWindowBounds(intent) {
+    const wDelta = intent.window.endTs - intent.window.startTs;
+    if (wDelta < MIN_WINDOW_MS || wDelta > MAX_WINDOW_MS) {
+        return {
+            name: 'integrity.window_bounds',
+            status: 'FAIL',
+            detail: {
+                reason: 'window out of bounds',
+                got: wDelta,
+                min: MIN_WINDOW_MS,
+                max: MAX_WINDOW_MS,
+            },
+        };
+    }
+    const rDelta = intent.spec.question.resolveTs - intent.window.endTs;
+    if (rDelta < 0 || rDelta > MAX_RESOLVE_GAP_MS) {
+        return {
+            name: 'integrity.window_bounds',
+            status: 'FAIL',
+            detail: {
+                reason: 'resolve gap out of bounds',
+                got: rDelta,
+                min: 0,
+                max: MAX_RESOLVE_GAP_MS,
+            },
+        };
+    }
+    return { name: 'integrity.window_bounds', status: 'PASS' };
+}
+export function checkManifestFieldsPresent(prediction) {
+    const p = Number(prediction.probability);
+    if (!Number.isFinite(p) || p < 0 || p > 1) {
+        return {
+            name: 'integrity.manifest_fields_present',
+            status: 'FAIL',
+            detail: { field: 'probability', got: prediction.probability },
+        };
+    }
+    if (!prediction.modelId || prediction.modelId.length === 0) {
+        return {
+            name: 'integrity.manifest_fields_present',
+            status: 'FAIL',
+            detail: { field: 'modelId' },
+        };
+    }
+    if (!Number.isInteger(prediction.submittedAt)) {
+        return {
+            name: 'integrity.manifest_fields_present',
+            status: 'FAIL',
+            detail: { field: 'submittedAt' },
+        };
+    }
+    return { name: 'integrity.manifest_fields_present', status: 'PASS' };
+}
+export async function checkManifestSignature(canonicalHash, signature) {
+    if (signature.algo !== 'secp256k1') {
+        return { name: 'integrity.manifest_signature', status: 'FAIL', detail: 'non-secp256k1 signature' };
+    }
+    if (signature.hash !== canonicalHash) {
+        return { name: 'integrity.manifest_signature', status: 'FAIL', detail: 'hash mismatch' };
+    }
+    try {
+        const recovered = await recoverAddress({ hash: canonicalHash, signature: signature.sig });
+        const ok = recovered.toLowerCase() === signature.signer.toLowerCase();
+        return {
+            name: 'integrity.manifest_signature',
+            status: ok ? 'PASS' : 'FAIL',
+            detail: ok ? undefined : { recovered, expected: signature.signer },
+        };
+    }
+    catch (err) {
+        return { name: 'integrity.manifest_signature', status: 'FAIL', detail: String(err) };
+    }
+}
+/** Verify the restorer's claimed intent CID matches the on-chain request. */
+export function checkIntentRef(manifestIntentCid, expectedIntentCid) {
+    return {
+        name: 'integrity.intent_ref',
+        status: manifestIntentCid === expectedIntentCid ? 'PASS' : 'FAIL',
+        detail: manifestIntentCid === expectedIntentCid ? undefined : { manifestIntentCid, expectedIntentCid },
+    };
+}
+//# sourceMappingURL=integrity.js.map

package/dist/restorer/impls/prediction-v0-evaluator/checks/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/prediction-v0-evaluator/checks/integrity.ts"],"names":[],"mappings":"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"}

package/dist/restorer/impls/prediction-v0-evaluator/checks/spec.d.ts

@@ -0,0 +1,5 @@
+import type { Check } from '../types.js';
+import type { PredictionV0Intent } from '../../../../types/prediction.js';
+export declare function checkQuestionKindSupported(question: PredictionV0Intent['spec']['question'] | {
+    kind: string;
+}): Check;

package/dist/restorer/impls/prediction-v0-evaluator/checks/spec.js

@@ -0,0 +1,20 @@
+export function checkQuestionKindSupported(question) {
+    if (question.kind === 'threshold') {
+        const op = question.operator;
+        const supported = ['GT', 'GTE', 'LT', 'LTE'].includes(op);
+        return {
+            name: 'spec.question_kind_supported',
+            status: supported ? 'PASS' : 'FAIL',
+            detail: supported ? undefined : { operator: op },
+        };
+    }
+    if (question.kind === 'range') {
+        return { name: 'spec.question_kind_supported', status: 'PASS' };
+    }
+    return {
+        name: 'spec.question_kind_supported',
+        status: 'FAIL',
+        detail: { kind: question.kind },
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/restorer/impls/prediction-v0-evaluator/checks/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/prediction-v0-evaluator/checks/spec.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,0BAA0B,CACxC,QAAmE;IAEnE,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,EAAE,GAAI,QAAgB,CAAC,QAAQ,CAAC;QACtC,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,IAAI,EAAE,8BAA8B;YACpC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACnC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;SACjD,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,8BAA8B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,8BAA8B;QACpC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC"}

package/dist/restorer/impls/prediction-v0-evaluator/index.d.ts

@@ -0,0 +1,33 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput } from '../../types.js';
+import type { DesiredState } from '../../../types/desired-state.js';
+import { type SpanningResult } from '../../../venues/chainlink/client.js';
+export interface PredictionV0EvaluatorConfig {
+    /** Evaluator's private key — used to sign the verdict manifest. */
+    evaluatorPk: `0x${string}`;
+    /** Evaluator's Safe multisig address — written into verdict.evaluator.safeAddress. */
+    evaluatorSafeAddress: `0x${string}`;
+    rpcUrl?: string;
+    _testDeps?: {
+        oraclePriceAtResolveTs?: (feed: `0x${string}`, resolveTs: number) => Promise<SpanningResult>;
+        /** Override the intentCid we expect to match — bypasses on-chain derivation for tests. */
+        expectedIntentCid?: string;
+    };
+}
+export declare class PredictionV0Evaluator implements RestorerImpl {
+    private readonly config;
+    readonly name = "prediction-v0-evaluator";
+    readonly version = "1.0.0";
+    constructor(config: PredictionV0EvaluatorConfig);
+    supports(ctx: {
+        kind: string;
+        type?: 'restoration' | 'evaluation';
+    }): boolean;
+    canAttempt(intent: DesiredState): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+}
+export default PredictionV0Evaluator;

package/dist/restorer/impls/prediction-v0-evaluator/index.js

@@ -0,0 +1,208 @@
+/**
+ * prediction-v0-evaluator — deterministic verifier for prediction.v0.
+ *
+ * §6 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ *
+ * Pipeline: availability → eligibility → integrity → spec → verdict.
+ * Score: brier.v1 scaled to 1e18 fixed-point.
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createPublicClient, http, keccak256, stringToHex } from 'viem';
+import { baseSepolia, base } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+import { PredictionV0IntentSchema, PredictionSubmissionManifestSchema, } from '../../../types/prediction.js';
+import { oraclePriceAtResolveTs, scaleToDecimal, } from '../../../venues/chainlink/client.js';
+import { resolveGroundTruth } from './canonical-metrics.js';
+import { computeScore } from './score.js';
+import { checkOracleReachable, checkOracleRoundCoversResolveTs } from './checks/availability.js';
+import { checkSubmissionWithinWindow } from './checks/eligibility.js';
+import { checkWindowBounds, checkManifestFieldsPresent, checkManifestSignature, checkIntentRef, } from './checks/integrity.js';
+import { checkQuestionKindSupported } from './checks/spec.js';
+function parseRestorationSubmissionManifest(manifestJson) {
+    const raw = JSON.parse(manifestJson);
+    const direct = PredictionSubmissionManifestSchema.safeParse(raw);
+    if (direct.success)
+        return direct.data;
+    if (raw['schemaVersion'] !== 'portfolio.v0.manifest.v1') {
+        return PredictionSubmissionManifestSchema.parse(raw);
+    }
+    const gating = raw['gating'];
+    const informational = raw['informational'];
+    const oracleSnapshot = informational?.['oracleSnapshot'];
+    const normalized = {
+        schemaVersion: 'prediction.v0.submission.v1',
+        generatedAt: raw['generatedAt'],
+        intent: raw['intent'],
+        restorer: raw['restorer'],
+        window: raw['window'],
+        prediction: {
+            probability: String(gating?.['probability'] ?? ''),
+            submittedAt: Number(gating?.['submittedAt']),
+            modelId: String(gating?.['modelId'] ?? ''),
+        },
+        ...(oracleSnapshot && typeof oracleSnapshot === 'object'
+            ? { oracleSnapshot }
+            : {}),
+        signature: raw['signature'],
+    };
+    return PredictionSubmissionManifestSchema.parse(normalized);
+}
+export class PredictionV0Evaluator {
+    config;
+    name = 'prediction-v0-evaluator';
+    version = '1.0.0';
+    constructor(config) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.kind === 'prediction.v0' && ctx.type === 'evaluation';
+    }
+    async canAttempt(intent) {
+        if (intent.spec?.kind !== 'prediction.v0')
+            return { ok: false, reason: 'spec.kind is not prediction.v0' };
+        if (intent.type !== 'evaluation')
+            return { ok: false, reason: 'type is not evaluation' };
+        if (!intent.restorationRequestId)
+            return { ok: false, reason: 'restorationRequestId is required' };
+        if (typeof intent.context?.['restorationResult'] !== 'string') {
+            return { ok: false, reason: 'context.restorationResult required' };
+        }
+        return { ok: true };
+    }
+    async run(ctx) {
+        const { intent, workingDir, log } = ctx;
+        // Support _testDeps injection from ctx (test) or config (constructor).
+        const testDeps = ctx._testDeps ?? this.config._testDeps;
+        // 1. Parse intent — same spec the restorer ran under
+        const predictionIntent = PredictionV0IntentSchema.parse(intent);
+        const { feed, venue } = predictionIntent.spec.oracle;
+        // 2. Parse restorer's manifest from inlined context
+        const manifestJson = intent.context['restorationResult'];
+        const manifest = parseRestorationSubmissionManifest(manifestJson);
+        // 3. Fetch Chainlink spanning round
+        let spanning;
+        if (testDeps?.oraclePriceAtResolveTs) {
+            spanning = await testDeps.oraclePriceAtResolveTs(feed, predictionIntent.spec.question.resolveTs);
+        }
+        else {
+            const expectedChainId = venue === 'chainlink-base' ? 8453 : 84532;
+            const chain = venue === 'chainlink-base' ? base : baseSepolia;
+            const publicClient = createPublicClient({
+                chain,
+                transport: http(this.config.rpcUrl),
+            });
+            const actualChainId = await publicClient.getChainId();
+            if (actualChainId !== expectedChainId) {
+                throw new Error(`oracle venue mismatch: spec says ${venue} (chainId ${expectedChainId}) but RPC chainId is ${actualChainId}`);
+            }
+            spanning = await oraclePriceAtResolveTs(feed, predictionIntent.spec.question.resolveTs, publicClient);
+        }
+        // 4. Run checks (order matters: availability → eligibility → integrity → spec)
+        const checks = [];
+        // availability — oracle reachable (already fetched above; re-wrap to surface errors)
+        checks.push(await checkOracleReachable(async () => spanning));
+        checks.push(checkOracleRoundCoversResolveTs(spanning));
+        // eligibility
+        checks.push(checkSubmissionWithinWindow(manifest.prediction.submittedAt, predictionIntent.window));
+        // integrity
+        checks.push(checkWindowBounds(predictionIntent));
+        checks.push(checkManifestFieldsPresent(manifest.prediction));
+        checks.push(await checkManifestSignature(manifest.signature.hash, manifest.signature));
+        checks.push(checkIntentRef(manifest.intent.cid, testDeps?.expectedIntentCid ?? manifest.intent.cid));
+        // spec
+        checks.push(checkQuestionKindSupported(predictionIntent.spec.question));
+        // 5. Derive verdict
+        const verdict = deriveVerdict(checks);
+        // 6. Derive ground truth + score
+        const priceAtResolve = scaleToDecimal(spanning.round.answer, spanning.round.decimals);
+        const groundTruth = resolveGroundTruth(predictionIntent.spec.question, priceAtResolve);
+        const { score, scoreBasis, scoreVersion } = computeScore(verdict, manifest.prediction.probability, groundTruth);
+        // 7. Assemble + sign verdict manifest
+        const evaluatorAccount = privateKeyToAccount(this.config.evaluatorPk);
+        const verdictManifestBase = {
+            schemaVersion: 'prediction.v0.verdict.v1',
+            generatedAt: Date.now(),
+            intent: manifest.intent,
+            evaluator: { safeAddress: this.config.evaluatorSafeAddress, agentEoa: evaluatorAccount.address },
+            window: predictionIntent.window,
+            verdict,
+            score,
+            scoreBasis,
+            scoreVersion,
+            oracleReading: {
+                feed: feed,
+                roundId: String(spanning.round.roundId),
+                answer: String(spanning.round.answer),
+                updatedAt: spanning.round.updatedAt,
+                ...(spanning.nextRound ? { nextRoundUpdatedAt: spanning.nextRound.updatedAt } : {}),
+            },
+            claimed: {
+                probability: manifest.prediction.probability,
+                submittedAt: manifest.prediction.submittedAt,
+                modelId: manifest.prediction.modelId,
+                submissionManifestCid: 'inline',
+            },
+            groundTruth,
+            checks,
+        };
+        const canonical = JSON.stringify(verdictManifestBase);
+        const hash = keccak256(stringToHex(canonical));
+        // Raw ECDSA — no EIP-191 prefix. recoverAddress (not recoverMessageAddress) on verify.
+        const sig = await evaluatorAccount.sign({ hash });
+        const verdictManifest = {
+            ...verdictManifestBase,
+            signature: { algo: 'secp256k1', signer: evaluatorAccount.address, hash, sig },
+        };
+        writeFileSync(join(workingDir, 'verdict.json'), JSON.stringify(verdictManifest, null, 2));
+        log({ level: 'info', msg: 'prediction-v0-evaluator: verdict', data: { verdict, score, groundTruth } });
+        return {
+            venueRef: { name: 'chainlink' },
+            gating: {
+                verdict,
+                score,
+                scoreBasis,
+                groundTruth,
+                checkCount: checks.length,
+                passCount: checks.filter(c => c.status === 'PASS').length,
+                failCount: checks.filter(c => c.status === 'FAIL').length,
+                skipCount: checks.filter(c => c.status === 'SKIP').length,
+            },
+            informational: {
+                claimedProbability: manifest.prediction.probability,
+                oracleReading: verdictManifestBase.oracleReading,
+            },
+            artifacts: [
+                {
+                    path: 'verdict.json',
+                    role: 'evaluation_verdict',
+                    metadata: { verdict, score, schemaVersion: 'prediction.v0.verdict.v1' },
+                    access: { kind: 'open' },
+                },
+            ],
+        };
+    }
+}
+/**
+ * Derive verdict from check statuses.
+ * Order matters: data-availability failures precede attempt-quality failures.
+ */
+function deriveVerdict(checks) {
+    // Any availability FAIL → INDETERMINATE (oracle unreachable, data gaps)
+    if (checks.some(c => c.name.startsWith('availability.') && c.status === 'FAIL'))
+        return 'INDETERMINATE';
+    // Any availability SKIP → INDETERMINATE (oracle not yet spanning)
+    if (checks.some(c => c.name.startsWith('availability.') && c.status === 'SKIP'))
+        return 'INDETERMINATE';
+    // Any eligibility FAIL → REJECTED
+    if (checks.some(c => c.name.startsWith('eligibility.') && c.status === 'FAIL'))
+        return 'REJECTED';
+    // Any integrity or spec FAIL → FAIL
+    if (checks.some(c => c.name.startsWith('integrity.') && c.status === 'FAIL') ||
+        checks.some(c => c.name.startsWith('spec.') && c.status === 'FAIL')) {
+        return 'FAIL';
+    }
+    return 'PASS';
+}
+export default PredictionV0Evaluator;
+//# sourceMappingURL=index.js.map

package/dist/restorer/impls/prediction-v0-evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-v0-evaluator/index.ts"],"names":[],"mappings":"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"}

package/dist/restorer/impls/prediction-v0-evaluator/score.d.ts

@@ -0,0 +1,8 @@
+export declare const SCORE_BASIS: "brier.v1";
+export declare const SCORE_VERSION: "1";
+export type Verdict = 'PASS' | 'FAIL' | 'REJECTED' | 'INDETERMINATE';
+export declare function computeScore(verdict: Verdict, probability: string, groundTruth: 'YES' | 'NO'): {
+    score: string;
+    scoreBasis: typeof SCORE_BASIS;
+    scoreVersion: typeof SCORE_VERSION;
+};