@jinn-network/client 0.1.1 → 0.1.2-canary.6237288d

package/dist/restorer/impls/prediction-apy-v0-baseline/index.js

@@ -0,0 +1,107 @@
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia, mainnet } from 'viem/chains';
+import { REQUIRES_LIVE_DAEMON_READINESS } from '../../types.js';
+import { PredictionApyV0IntentSchema } from '../../../types/prediction-apy.js';
+import { twApyBpsOverWindow } from '../../../venues/aave-v3/client.js';
+import { persistencePredict } from './strategy.js';
+function chainForVenue(venue) {
+    if (venue === 'aave-v3-base-sepolia')
+        return { chain: baseSepolia, chainId: 84532 };
+    if (venue === 'aave-v3-mainnet')
+        return { chain: mainnet, chainId: 1 };
+    return { chain: base, chainId: 8453 };
+}
+export class PredictionApyV0BaselineImpl {
+    config;
+    name = 'prediction-apy-v0-baseline';
+    version = '1.0.0';
+    constructor(config = {}) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.kind === 'prediction.apy.v0' && ctx.type !== 'evaluation';
+    }
+    async isReady() {
+        if (this.config.stub)
+            return { ...REQUIRES_LIVE_DAEMON_READINESS };
+        return { ready: true };
+    }
+    enableMetadata() {
+        return {
+            description: 'prediction.apy.v0 — submit APY prediction in bps from Aave v3 reserve data.',
+        };
+    }
+    async onEnable(_args) {
+        return { status: 'ready' };
+    }
+    async canAttempt(intent) {
+        const parsed = PredictionApyV0IntentSchema.safeParse(intent);
+        if (!parsed.success)
+            return { ok: false, reason: `Invalid prediction.apy.v0 intent: ${parsed.error.message}` };
+        if (Date.now() > parsed.data.window.endTs)
+            return { ok: false, reason: 'window already closed' };
+        return { ok: true };
+    }
+    async run(ctx) {
+        if (this.config.stub) {
+            throw new Error('prediction-apy-v0-baseline: stub registry cannot run (requires live daemon)');
+        }
+        const parsed = PredictionApyV0IntentSchema.parse(ctx.intent);
+        const { venue, pool, reserve } = parsed.spec.oracle;
+        const { chain, chainId } = chainForVenue(venue);
+        const rpcUrl = this.config.archiveRpcUrl ?? this.config.rpcUrl;
+        // At submission time, resolveTs is usually in the future — cap the TWA
+        // window end at "now" so we only sample historical state (persistence baseline).
+        const windowEndForTwa = Math.min(parsed.spec.question.resolveTs, Date.now());
+        let twApyBps;
+        let sampleCount;
+        if (this.config._testDeps?.twApyBpsOverWindow) {
+            const result = await this.config._testDeps.twApyBpsOverWindow({
+                pool: pool,
+                reserve: reserve,
+                windowEndTs: windowEndForTwa,
+                twaWindowSeconds: parsed.spec.metric.twaWindowSeconds,
+                sampleCount: parsed.spec.metric.sampleCount,
+            });
+            twApyBps = result.twApyBps;
+            sampleCount = result.sampleCount;
+        }
+        else {
+            const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+            const actual = await publicClient.getChainId();
+            if (actual !== chainId) {
+                throw new Error(`oracle venue mismatch: ${venue} expects chain ${chainId}, got ${actual}`);
+            }
+            const result = await twApyBpsOverWindow({
+                publicClient,
+                pool: pool,
+                reserve: reserve,
+                windowEndTs: windowEndForTwa,
+                twaWindowSeconds: parsed.spec.metric.twaWindowSeconds,
+                sampleCount: parsed.spec.metric.sampleCount,
+            });
+            twApyBps = result.twApyBps;
+            sampleCount = result.sampleCount;
+        }
+        const prediction = persistencePredict(twApyBps);
+        const submittedAt = Date.now();
+        writeFileSync(join(ctx.workingDir, 'prediction-apy.json'), JSON.stringify({ ...prediction, submittedAt, twApyBps }, null, 2));
+        return {
+            venueRef: { name: 'aave-v3' },
+            gating: {
+                predictedBps: prediction.predictedBps,
+                submittedAt: String(submittedAt),
+                modelId: prediction.modelId,
+            },
+            informational: {
+                twApyBps,
+                sampleCount,
+            },
+            artifacts: [{ path: 'prediction-apy.json', role: 'prediction_submission' }],
+        };
+    }
+}
+export default PredictionApyV0BaselineImpl;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { StrategyPrediction } from './types.js';
+export declare function persistencePredict(twApyBps: number): StrategyPrediction;

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

@@ -0,0 +1,7 @@
+export function persistencePredict(twApyBps) {
+    return {
+        predictedBps: String(Math.round(twApyBps)),
+        modelId: 'apy-persistence.v1',
+    };
+}
+//# sourceMappingURL=strategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-apy-v0-baseline/strategy.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,EAAE,oBAAoB;KAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+export interface StrategyPrediction {
+    predictedBps: string;
+    modelId: string;
+}

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

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

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

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

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

@@ -0,0 +1,6 @@
+import type { PredictionApyV0Intent } from '../../../types/prediction-apy.js';
+/**
+ * Shell for future metric kinds: today `twApyBps` is already integer-rounded
+ * from the Aave client; this keeps a single hook if we add more `metric.type`s.
+ */
+export declare function deriveGroundTruthBps(intent: PredictionApyV0Intent, twApyBps: number): string;

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

@@ -0,0 +1,11 @@
+/**
+ * Shell for future metric kinds: today `twApyBps` is already integer-rounded
+ * from the Aave client; this keeps a single hook if we add more `metric.type`s.
+ */
+export function deriveGroundTruthBps(intent, twApyBps) {
+    if (intent.spec.metric.type !== 'supply-apy-twa-bps') {
+        throw new Error(`unsupported metric: ${intent.spec.metric.type}`);
+    }
+    return String(Math.round(twApyBps));
+}
+//# sourceMappingURL=canonical-metrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-metrics.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-apy-v0-evaluator/canonical-metrics.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA6B,EAAE,QAAgB;IAClF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus } from '../../types.js';
+import type { DesiredState } from '../../../types/desired-state.js';
+export interface PredictionApyV0EvaluatorConfig {
+    stub?: boolean;
+    evaluatorPk?: `0x${string}`;
+    evaluatorSafeAddress?: `0x${string}`;
+    rpcUrl?: string;
+    archiveRpcUrl?: string;
+    _testDeps?: {
+        twApyBpsOverWindow?: (args: {
+            windowEndTs: number;
+            twaWindowSeconds: number;
+            sampleCount: number;
+            pool: `0x${string}`;
+            reserve: `0x${string}`;
+        }) => Promise<{
+            twApyBps: number;
+            sampleCount: number;
+        }>;
+        expectedIntentCid?: string;
+    };
+}
+export declare class PredictionApyV0Evaluator implements RestorerImpl {
+    private readonly config;
+    readonly name = "prediction-apy-v0-evaluator";
+    readonly version = "1.0.0";
+    constructor(config: PredictionApyV0EvaluatorConfig);
+    supports(ctx: {
+        kind: string;
+        type?: 'restoration' | 'evaluation';
+    }): boolean;
+    isReady(): Promise<ReadyStatus>;
+    canAttempt(intent: DesiredState): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+}
+export { parsePredictionApySubmissionManifest } from './parse-submission.js';
+export default PredictionApyV0Evaluator;

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

@@ -0,0 +1,208 @@
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createPublicClient, http, keccak256, stringToHex } from 'viem';
+import { base, baseSepolia, mainnet } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+import { REQUIRES_LIVE_DAEMON_READINESS } from '../../types.js';
+import { PredictionApyV0IntentSchema } from '../../../types/prediction-apy.js';
+import { twApyBpsOverWindow } from '../../../venues/aave-v3/client.js';
+import { checkIntentRef, checkIntentRefMissingExpected, checkManifestSignature, recomputeTopLevelSignatureHash, } from '../prediction-v0-evaluator/checks/integrity.js';
+import { resolveExpectedRestorationIntentCid } from '../evaluation-context.js';
+import { deriveGroundTruthBps } from './canonical-metrics.js';
+import { parsePredictionApySubmissionManifest } from './parse-submission.js';
+import { computeScore } from './score.js';
+function chainForVenue(venue) {
+    if (venue === 'aave-v3-base-sepolia')
+        return { chain: baseSepolia, chainId: 84532 };
+    if (venue === 'aave-v3-mainnet')
+        return { chain: mainnet, chainId: 1 };
+    return { chain: base, chainId: 8453 };
+}
+export class PredictionApyV0Evaluator {
+    config;
+    name = 'prediction-apy-v0-evaluator';
+    version = '1.0.0';
+    constructor(config) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.kind === 'prediction.apy.v0' && ctx.type === 'evaluation';
+    }
+    async isReady() {
+        if (this.config.stub)
+            return { ...REQUIRES_LIVE_DAEMON_READINESS };
+        return { ready: true };
+    }
+    async canAttempt(intent) {
+        if (intent.spec?.kind !== 'prediction.apy.v0')
+            return { ok: false, reason: 'spec.kind is not prediction.apy.v0' };
+        if (intent.type !== 'evaluation')
+            return { ok: false, reason: 'type is not evaluation' };
+        if (typeof intent.context?.['restorationResult'] !== 'string') {
+            return { ok: false, reason: 'context.restorationResult required' };
+        }
+        return { ok: true };
+    }
+    async run(ctx) {
+        if (this.config.stub) {
+            throw new Error('prediction-apy-v0-evaluator: stub registry cannot run evaluation (requires live daemon)');
+        }
+        if (!this.config.evaluatorPk || !this.config.evaluatorSafeAddress) {
+            throw new Error('prediction-apy-v0-evaluator: evaluatorPk and evaluatorSafeAddress are required');
+        }
+        const testDeps = ctx._testDeps
+            ?? this.config._testDeps;
+        const expectedRef = resolveExpectedRestorationIntentCid(ctx.intent, testDeps);
+        const intent = PredictionApyV0IntentSchema.parse(ctx.intent);
+        const manifestJson = ctx.intent.context['restorationResult'];
+        const rawPayload = JSON.parse(manifestJson);
+        const submission = parsePredictionApySubmissionManifest(manifestJson);
+        const checks = [];
+        const { venue, pool, reserve } = intent.spec.oracle;
+        const { chain, chainId } = chainForVenue(venue);
+        let twApyBps;
+        let sampleCount;
+        try {
+            if (testDeps?.twApyBpsOverWindow) {
+                const result = await testDeps.twApyBpsOverWindow({
+                    pool: pool,
+                    reserve: reserve,
+                    windowEndTs: intent.spec.question.resolveTs,
+                    twaWindowSeconds: intent.spec.metric.twaWindowSeconds,
+                    sampleCount: intent.spec.metric.sampleCount,
+                });
+                twApyBps = result.twApyBps;
+                sampleCount = result.sampleCount;
+            }
+            else {
+                const rpcUrl = this.config.archiveRpcUrl ?? this.config.rpcUrl;
+                const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+                const actual = await publicClient.getChainId();
+                if (actual !== chainId) {
+                    throw new Error(`oracle venue mismatch: ${venue} expects chain ${chainId}, got ${actual}`);
+                }
+                const result = await twApyBpsOverWindow({
+                    publicClient,
+                    pool: pool,
+                    reserve: reserve,
+                    windowEndTs: intent.spec.question.resolveTs,
+                    twaWindowSeconds: intent.spec.metric.twaWindowSeconds,
+                    sampleCount: intent.spec.metric.sampleCount,
+                });
+                twApyBps = result.twApyBps;
+                sampleCount = result.sampleCount;
+            }
+            checks.push({ name: 'availability.aave_readable', status: 'PASS' });
+        }
+        catch (error) {
+            checks.push({ name: 'availability.aave_readable', status: 'FAIL', detail: String(error) });
+            twApyBps = 0;
+            sampleCount = 0;
+        }
+        {
+            const sa = submission.prediction.submittedAt;
+            const w = intent.window;
+            const within = sa >= w.startTs && sa < w.endTs;
+            checks.push({
+                name: 'eligibility.submission_within_window',
+                status: within ? 'PASS' : 'FAIL',
+                detail: within ? undefined : { submittedAt: sa, startTs: w.startTs, endTs: w.endTs },
+            });
+        }
+        {
+            const sa = submission.prediction.submittedAt;
+            const w = intent.window;
+            const maxDelay = intent.eligibility.maxSubmissionDelayMs;
+            const within = sa <= w.startTs + maxDelay;
+            checks.push({
+                name: 'eligibility.submission_within_max_delay',
+                status: within ? 'PASS' : 'FAIL',
+                detail: within
+                    ? undefined
+                    : { submittedAt: sa, startTs: w.startTs, maxSubmissionDelayMs: maxDelay },
+            });
+        }
+        {
+            const recomputed = recomputeTopLevelSignatureHash(rawPayload);
+            checks.push(await checkManifestSignature(recomputed, submission.signature));
+        }
+        if (expectedRef.kind === 'missing') {
+            checks.push(checkIntentRefMissingExpected());
+        }
+        else {
+            checks.push(checkIntentRef(submission.intent.cid, expectedRef.cid));
+        }
+        if (intent.spec.metric.toleranceBps > 0) {
+            checks.push({ name: 'spec.tolerance_positive', status: 'PASS' });
+        }
+        else {
+            checks.push({ name: 'spec.tolerance_positive', status: 'FAIL' });
+        }
+        const verdict = deriveVerdict(checks);
+        const groundTruthBps = deriveGroundTruthBps(intent, twApyBps);
+        const scored = computeScore(verdict, submission.prediction.predictedBps, groundTruthBps, intent.spec.metric.toleranceBps);
+        const evaluatorAccount = privateKeyToAccount(this.config.evaluatorPk);
+        const baseManifest = {
+            schemaVersion: 'prediction.apy.v0.verdict.v1',
+            generatedAt: Date.now(),
+            intent: submission.intent,
+            evaluator: { safeAddress: this.config.evaluatorSafeAddress, agentEoa: evaluatorAccount.address },
+            window: intent.window,
+            verdict,
+            score: scored.score,
+            scoreBasis: scored.scoreBasis,
+            scoreVersion: scored.scoreVersion,
+            oracleReading: {
+                pool: pool,
+                reserve: reserve,
+                sampleCount,
+                twaWindowSeconds: intent.spec.metric.twaWindowSeconds,
+                resolveTs: intent.spec.question.resolveTs,
+            },
+            claimed: {
+                predictedBps: submission.prediction.predictedBps,
+                submittedAt: submission.prediction.submittedAt,
+                modelId: submission.prediction.modelId,
+            },
+            groundTruth: {
+                twApyBps: groundTruthBps,
+                errorBps: scored.errorBps,
+            },
+            checks,
+        };
+        const hash = keccak256(stringToHex(JSON.stringify(baseManifest)));
+        const sig = await evaluatorAccount.sign({ hash });
+        const verdictManifest = {
+            ...baseManifest,
+            signature: { algo: 'secp256k1', signer: evaluatorAccount.address, hash, sig },
+        };
+        writeFileSync(join(ctx.workingDir, 'verdict.json'), JSON.stringify(verdictManifest, null, 2));
+        return {
+            venueRef: { name: 'aave-v3' },
+            gating: {
+                verdict,
+                score: scored.score,
+                groundTruthBps,
+                errorBps: scored.errorBps,
+            },
+            informational: {
+                predictedBps: submission.prediction.predictedBps,
+            },
+            artifacts: [{ path: 'verdict.json', role: 'evaluation_verdict' }],
+        };
+    }
+}
+function deriveVerdict(checks) {
+    if (checks.some((c) => c.name.startsWith('availability.') && c.status !== 'PASS'))
+        return 'INDETERMINATE';
+    if (checks.some((c) => c.name.startsWith('integrity.') && c.status === 'INDETERMINATE'))
+        return 'INDETERMINATE';
+    if (checks.some((c) => c.name.startsWith('eligibility.') && c.status === 'FAIL'))
+        return 'REJECTED';
+    if (checks.some((c) => (c.name.startsWith('integrity.') || c.name.startsWith('spec.')) && c.status === 'FAIL'))
+        return 'FAIL';
+    return 'PASS';
+}
+export { parsePredictionApySubmissionManifest } from './parse-submission.js';
+export default PredictionApyV0Evaluator;
+//# sourceMappingURL=index.js.map

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

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

package/dist/restorer/impls/prediction-apy-v0-evaluator/parse-submission.d.ts

@@ -0,0 +1,7 @@
+import { type PredictionApySubmissionManifest } from '../../../types/prediction-apy.js';
+/**
+ * Parse a restoration submission for prediction.apy.v0. Engine-wrapped jobs store
+ * the prediction under `gating` (see manifest assembly); direct IPFS manifests
+ * use `prediction` per schema.
+ */
+export declare function parsePredictionApySubmissionManifest(manifestJson: string): PredictionApySubmissionManifest;

package/dist/restorer/impls/prediction-apy-v0-evaluator/parse-submission.js

@@ -0,0 +1,29 @@
+import { PredictionApySubmissionManifestSchema, } from '../../../types/prediction-apy.js';
+/**
+ * Parse a restoration submission for prediction.apy.v0. Engine-wrapped jobs store
+ * the prediction under `gating` (see manifest assembly); direct IPFS manifests
+ * use `prediction` per schema.
+ */
+export function parsePredictionApySubmissionManifest(manifestJson) {
+    const raw = JSON.parse(manifestJson);
+    const gating = raw['gating'];
+    const gatingBps = gating?.['predictedBps'];
+    if (gating && (typeof gatingBps === 'string' || typeof gatingBps === 'number')) {
+        const normalized = {
+            schemaVersion: 'prediction.apy.v0.submission.v1',
+            generatedAt: raw['generatedAt'] ?? Date.now(),
+            intent: raw['intent'],
+            restorer: raw['restorer'],
+            window: raw['window'],
+            prediction: {
+                predictedBps: String(gatingBps),
+                submittedAt: Number(gating['submittedAt'] ?? 0),
+                modelId: String(gating['modelId'] ?? ''),
+            },
+            signature: raw['signature'],
+        };
+        return PredictionApySubmissionManifestSchema.parse(normalized);
+    }
+    return PredictionApySubmissionManifestSchema.parse(raw);
+}
+//# sourceMappingURL=parse-submission.js.map

package/dist/restorer/impls/prediction-apy-v0-evaluator/parse-submission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-submission.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-apy-v0-evaluator/parse-submission.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,GAEtC,MAAM,kCAAkC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,oCAAoC,CAAC,YAAoB;IACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAA4B,CAAC;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAwC,CAAC;IACpE,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,MAAM,IAAI,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC/E,MAAM,UAAU,GAAG;YACjB,aAAa,EAAE,iCAAiC;YAChD,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;YAC7C,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;YACrB,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;YACzB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;YACrB,UAAU,EAAE;gBACV,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC;gBAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;aACzC;YACD,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC;SAC5B,CAAC;QACF,OAAO,qCAAqC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,qCAAqC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { Verdict } from './types.js';
+export declare const SCORE_BASIS: "absolute-error-linear.v1";
+export declare const SCORE_VERSION: "1";
+export declare function computeScore(verdict: Verdict, predictedBps: string, groundTruthBps: string, toleranceBps: number): {
+    score: string;
+    scoreBasis: typeof SCORE_BASIS;
+    scoreVersion: typeof SCORE_VERSION;
+    errorBps: string;
+};

package/dist/restorer/impls/prediction-apy-v0-evaluator/score.js

@@ -0,0 +1,20 @@
+export const SCORE_BASIS = 'absolute-error-linear.v1';
+export const SCORE_VERSION = '1';
+const SCALE = 1000000000000000000n;
+export function computeScore(verdict, predictedBps, groundTruthBps, toleranceBps) {
+    const p = BigInt(predictedBps);
+    const g = BigInt(groundTruthBps);
+    const err = p > g ? p - g : g - p;
+    if (verdict !== 'PASS') {
+        return { score: '0', scoreBasis: SCORE_BASIS, scoreVersion: SCORE_VERSION, errorBps: err.toString() };
+    }
+    const tol = BigInt(toleranceBps);
+    if (tol <= 0n)
+        throw new Error('toleranceBps must be positive');
+    if (err >= tol) {
+        return { score: '0', scoreBasis: SCORE_BASIS, scoreVersion: SCORE_VERSION, errorBps: err.toString() };
+    }
+    const score = ((tol - err) * SCALE) / tol;
+    return { score: score.toString(), scoreBasis: SCORE_BASIS, scoreVersion: SCORE_VERSION, errorBps: err.toString() };
+}
+//# sourceMappingURL=score.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../../src/restorer/impls/prediction-apy-v0-evaluator/score.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG,0BAAmC,CAAC;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,CAAC;AAC1C,MAAM,KAAK,GAAG,oBAA0B,CAAC;AAEzC,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,YAAoB,EACpB,cAAsB,EACtB,YAAoB;IAEpB,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;IACxG,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACjC,IAAI,GAAG,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChE,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;IACxG,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;AACrH,CAAC"}

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

@@ -0,0 +1,7 @@
+export type CheckStatus = 'PASS' | 'FAIL' | 'SKIP' | 'INDETERMINATE';
+export interface Check {
+    name: string;
+    status: CheckStatus;
+    detail?: string | Record<string, unknown>;
+}
+export type Verdict = 'PASS' | 'FAIL' | 'REJECTED' | 'INDETERMINATE';

package/dist/restorer/impls/prediction-apy-v0-evaluator/types.js

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

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

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

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

@@ -0,0 +1,31 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus, EnableResult, IntentEnableMetadata } from '../../types.js';
+import { type RoundReading } from '../../../venues/chainlink/client.js';
+export interface PredictionV0BaselineConfig {
+    rpcUrl?: string;
+    /** CLI registries that cannot execute intents without the daemon. */
+    stub?: boolean;
+    _testDeps?: {
+        readChainlink?: (feed: `0x${string}`) => Promise<RoundReading>;
+    };
+}
+export declare class PredictionV0BaselineImpl implements RestorerImpl {
+    private readonly config;
+    readonly name = "prediction-v0-baseline";
+    readonly version = "1.0.0";
+    constructor(config?: PredictionV0BaselineConfig);
+    supports(ctx: {
+        kind: string;
+        type?: 'restoration' | 'evaluation';
+    }): boolean;
+    isReady(): Promise<ReadyStatus>;
+    enableMetadata(): IntentEnableMetadata;
+    onEnable(_args: Record<string, string | undefined>): Promise<EnableResult>;
+    canAttempt(intent: import('../../../types/desired-state.js').DesiredState): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+}
+export default PredictionV0BaselineImpl;