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

package/dist/restorer/impls/portfolio-v0-evaluator/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared types for the portfolio-v0-evaluator.
+ *
+ * Single source of truth for Check, Verdict, and related types.
+ * Import from here instead of declaring locally in each check module.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus, EnableResult, IntentEnableMetadata } from '../../types.js';
+export interface PredictionApyV0BaselineConfig {
+    rpcUrl?: string;
+    archiveRpcUrl?: string;
+    _testDeps?: {
+        twApyBpsOverWindow?: (args: {
+            windowEndTs: number;
+            twaWindowSeconds: number;
+            sampleCount: number;
+            pool: `0x${string}`;
+            reserve: `0x${string}`;
+        }) => Promise<{
+            twApyBps: number;
+            sampleCount: number;
+        }>;
+    };
+}
+export declare class PredictionApyV0BaselineImpl implements RestorerImpl {
+    private readonly config;
+    readonly name = "prediction-apy-v0-baseline";
+    readonly version = "1.0.0";
+    constructor(config?: PredictionApyV0BaselineConfig);
+    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: false;
+        reason: string;
+    } | {
+        ok: true;
+        reason?: undefined;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+}
+export default PredictionApyV0BaselineImpl;

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

@@ -0,0 +1,98 @@
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia, mainnet } from 'viem/chains';
+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() {
+        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) {
+        const parsed = PredictionApyV0IntentSchema.parse(ctx.intent);
+        const { venue, pool, reserve } = parsed.spec.oracle;
+        const { chain, chainId } = chainForVenue(venue);
+        const rpcUrl = this.config.rpcUrl ?? this.config.archiveRpcUrl;
+        let twApyBps;
+        let sampleCount;
+        if (this.config._testDeps?.twApyBpsOverWindow) {
+            const result = await this.config._testDeps.twApyBpsOverWindow({
+                pool: pool,
+                reserve: reserve,
+                windowEndTs: parsed.spec.question.resolveTs,
+                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: parsed.spec.question.resolveTs,
+                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,2 @@
+import type { PredictionApyV0Intent } from '../../../types/prediction-apy.js';
+export declare function deriveGroundTruthBps(intent: PredictionApyV0Intent, twApyBps: number): string;

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

@@ -0,0 +1,7 @@
+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,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,39 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput } from '../../types.js';
+import type { DesiredState } from '../../../types/desired-state.js';
+export interface PredictionApyV0EvaluatorConfig {
+    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;
+    canAttempt(intent: DesiredState): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+}
+export default PredictionApyV0Evaluator;

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

@@ -0,0 +1,186 @@
+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 { PredictionApyV0IntentSchema, PredictionApySubmissionManifestSchema, } from '../../../types/prediction-apy.js';
+import { twApyBpsOverWindow } from '../../../venues/aave-v3/client.js';
+import { deriveGroundTruthBps } from './canonical-metrics.js';
+import { computeScore } from './score.js';
+function parseSubmissionManifest(manifestJson) {
+    const raw = JSON.parse(manifestJson);
+    const direct = PredictionApySubmissionManifestSchema.safeParse(raw);
+    if (direct.success)
+        return direct.data;
+    const normalized = {
+        schemaVersion: 'prediction.apy.v0.submission.v1',
+        generatedAt: raw['generatedAt'],
+        intent: raw['intent'],
+        restorer: raw['restorer'],
+        window: raw['window'],
+        prediction: {
+            predictedBps: String(raw['gating']?.['predictedBps'] ?? ''),
+            submittedAt: Number(raw['gating']?.['submittedAt'] ?? 0),
+            modelId: String(raw['gating']?.['modelId'] ?? ''),
+        },
+        signature: raw['signature'],
+    };
+    return PredictionApySubmissionManifestSchema.parse(normalized);
+}
+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 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) {
+        const intent = PredictionApyV0IntentSchema.parse(ctx.intent);
+        const submission = parseSubmissionManifest(ctx.intent.context['restorationResult']);
+        const checks = [];
+        const { venue, pool, reserve } = intent.spec.oracle;
+        const { chain, chainId } = chainForVenue(venue);
+        let twApyBps;
+        let sampleCount;
+        try {
+            if (this.config._testDeps?.twApyBpsOverWindow) {
+                const result = await this.config._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;
+        }
+        if (submission.prediction.submittedAt >= intent.window.startTs &&
+            submission.prediction.submittedAt <= intent.window.endTs) {
+            checks.push({ name: 'eligibility.submission_within_window', status: 'PASS' });
+        }
+        else {
+            checks.push({ name: 'eligibility.submission_within_window', status: 'FAIL' });
+        }
+        if (submission.intent.cid === (this.config._testDeps?.expectedIntentCid ?? submission.intent.cid)) {
+            checks.push({ name: 'integrity.intent_ref', status: 'PASS' });
+        }
+        else {
+            checks.push({ name: 'integrity.intent_ref', status: 'FAIL' });
+        }
+        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,
+                submissionManifestCid: 'inline',
+            },
+            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('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 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/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';
+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,29 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus, EnableResult, IntentEnableMetadata } from '../../types.js';
+import { type RoundReading } from '../../../venues/chainlink/client.js';
+export interface PredictionV0BaselineConfig {
+    rpcUrl?: string;
+    _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;

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

@@ -0,0 +1,94 @@
+/**
+ * prediction-v0-baseline — reference RestorerImpl for prediction.v0.
+ *
+ * §5 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createPublicClient, http } from 'viem';
+import { baseSepolia, base } from 'viem/chains';
+import { PredictionV0IntentSchema } from '../../../types/prediction.js';
+import { readChainlinkLatest, scaleToDecimal, } from '../../../venues/chainlink/client.js';
+import { spotCarryPredict } from './strategy.js';
+export class PredictionV0BaselineImpl {
+    config;
+    name = 'prediction-v0-baseline';
+    version = '1.0.0';
+    constructor(config = {}) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.kind === 'prediction.v0' && ctx.type !== 'evaluation';
+    }
+    async isReady() {
+        // Zero external deps — prediction.v0 runs against on-chain oracles only.
+        return { ready: true };
+    }
+    enableMetadata() {
+        return {
+            description: 'prediction.v0 — submit probability predictions against on-chain price feeds. No external credentials required.',
+        };
+    }
+    async onEnable(_args) {
+        return { status: 'ready' };
+    }
+    async canAttempt(intent) {
+        const parsed = PredictionV0IntentSchema.safeParse(intent);
+        if (!parsed.success)
+            return { ok: false, reason: `Invalid prediction.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) {
+        const { intent, workingDir, log } = ctx;
+        const parsed = PredictionV0IntentSchema.parse(intent);
+        const { feed, venue } = parsed.spec.oracle;
+        log({ level: 'info', msg: 'prediction-v0-baseline: starting', data: { feed, venue } });
+        // Read the feed (injection seam for tests)
+        const read = this.config._testDeps?.readChainlink;
+        let snapshot;
+        if (read) {
+            snapshot = await read(feed);
+        }
+        else {
+            const expectedChainId = venue === 'chainlink-base' ? 8453 : 84532;
+            const chain = venue === 'chainlink-base' ? base : baseSepolia;
+            const pc = createPublicClient({ chain, transport: http(this.config.rpcUrl) });
+            const actualChainId = await pc.getChainId();
+            if (actualChainId !== expectedChainId) {
+                throw new Error(`oracle venue mismatch: spec says ${venue} (chainId ${expectedChainId}) but RPC chainId is ${actualChainId}`);
+            }
+            snapshot = await readChainlinkLatest(feed, pc);
+        }
+        const currentPrice = scaleToDecimal(snapshot.answer, snapshot.decimals);
+        const { probability, modelId } = spotCarryPredict(parsed, currentPrice);
+        const submittedAt = Date.now();
+        const prediction = { probability, submittedAt, modelId };
+        writeFileSync(join(workingDir, 'prediction.json'), JSON.stringify(prediction, null, 2));
+        log({ level: 'info', msg: 'prediction-v0-baseline: submitted', data: { currentPrice, probability, modelId } });
+        return {
+            venueRef: { name: 'chainlink' },
+            gating: {
+                probability,
+                submittedAt: String(submittedAt),
+                modelId,
+            },
+            informational: {
+                oracleSnapshot: {
+                    feed,
+                    roundId: String(snapshot.roundId),
+                    answer: String(snapshot.answer),
+                    updatedAt: snapshot.updatedAt,
+                },
+                currentPrice,
+            },
+            artifacts: [
+                { path: 'prediction.json', role: 'prediction_submission' },
+            ],
+        };
+    }
+}
+export default PredictionV0BaselineImpl;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Spot-carry baseline — "current state tends to persist."
+ *
+ * §5.3 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ */
+import type { PredictionV0Intent } from '../../../types/prediction.js';
+import type { StrategyPrediction } from './types.js';
+export declare function spotCarryPredict(intent: PredictionV0Intent, currentPrice: string): StrategyPrediction;