@jinn-network/client 0.1.0 → 0.1.1-canary.4a6ed8b2

package/dist/types/prediction.d.ts

@@ -0,0 +1,751 @@
+/**
+ * prediction.v0 — typed intent spec, submission manifest, verdict manifest.
+ *
+ * §4 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ */
+import { z } from 'zod';
+export declare const PredictionV0SpecSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"prediction.v0">;
+    oracle: z.ZodObject<{
+        venue: z.ZodEnum<["chainlink-base-sepolia", "chainlink-base"]>;
+        feed: z.ZodString;
+        feedDescription: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        venue: "chainlink-base-sepolia" | "chainlink-base";
+        feed: string;
+        feedDescription: string;
+    }, {
+        venue: "chainlink-base-sepolia" | "chainlink-base";
+        feed: string;
+        feedDescription: string;
+    }>;
+    question: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"threshold">;
+        operator: z.ZodEnum<["GT", "GTE", "LT", "LTE"]>;
+        threshold: z.ZodString;
+        resolveTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "threshold";
+        threshold: string;
+        operator: "GT" | "GTE" | "LT" | "LTE";
+        resolveTs: number;
+    }, {
+        kind: "threshold";
+        threshold: string;
+        operator: "GT" | "GTE" | "LT" | "LTE";
+        resolveTs: number;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"range">;
+        lowerBound: z.ZodString;
+        upperBound: z.ZodString;
+        resolveTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "range";
+        resolveTs: number;
+        lowerBound: string;
+        upperBound: string;
+    }, {
+        kind: "range";
+        resolveTs: number;
+        lowerBound: string;
+        upperBound: string;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    kind: "prediction.v0";
+    oracle: {
+        venue: "chainlink-base-sepolia" | "chainlink-base";
+        feed: string;
+        feedDescription: string;
+    };
+    question: {
+        kind: "threshold";
+        threshold: string;
+        operator: "GT" | "GTE" | "LT" | "LTE";
+        resolveTs: number;
+    } | {
+        kind: "range";
+        resolveTs: number;
+        lowerBound: string;
+        upperBound: string;
+    };
+}, {
+    kind: "prediction.v0";
+    oracle: {
+        venue: "chainlink-base-sepolia" | "chainlink-base";
+        feed: string;
+        feedDescription: string;
+    };
+    question: {
+        kind: "threshold";
+        threshold: string;
+        operator: "GT" | "GTE" | "LT" | "LTE";
+        resolveTs: number;
+    } | {
+        kind: "range";
+        resolveTs: number;
+        lowerBound: string;
+        upperBound: string;
+    };
+}>;
+export type PredictionV0Spec = z.infer<typeof PredictionV0SpecSchema>;
+export declare const PredictionV0EligibilitySchema: z.ZodObject<{
+    maxSubmissionDelayMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxSubmissionDelayMs: number;
+}, {
+    maxSubmissionDelayMs?: number | undefined;
+}>;
+export type PredictionV0Eligibility = z.infer<typeof PredictionV0EligibilitySchema>;
+export declare const PredictionV0IntentSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    window: z.ZodObject<{
+        startTs: z.ZodNumber;
+        endTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startTs: number;
+        endTs: number;
+    }, {
+        startTs: number;
+        endTs: number;
+    }>;
+    spec: z.ZodObject<{
+        kind: z.ZodLiteral<"prediction.v0">;
+        oracle: z.ZodObject<{
+            venue: z.ZodEnum<["chainlink-base-sepolia", "chainlink-base"]>;
+            feed: z.ZodString;
+            feedDescription: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        }, {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        }>;
+        question: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"threshold">;
+            operator: z.ZodEnum<["GT", "GTE", "LT", "LTE"]>;
+            threshold: z.ZodString;
+            resolveTs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        }, {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"range">;
+            lowerBound: z.ZodString;
+            upperBound: z.ZodString;
+            resolveTs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        }, {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    }, {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    }>;
+    eligibility: z.ZodDefault<z.ZodObject<{
+        maxSubmissionDelayMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxSubmissionDelayMs: number;
+    }, {
+        maxSubmissionDelayMs?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    };
+    eligibility: {
+        maxSubmissionDelayMs: number;
+    };
+}, {
+    id: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    };
+    eligibility?: {
+        maxSubmissionDelayMs?: number | undefined;
+    } | undefined;
+}>, {
+    id: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    };
+    eligibility: {
+        maxSubmissionDelayMs: number;
+    };
+}, {
+    id: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    };
+    eligibility?: {
+        maxSubmissionDelayMs?: number | undefined;
+    } | undefined;
+}>, {
+    id: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    };
+    eligibility: {
+        maxSubmissionDelayMs: number;
+    };
+}, {
+    id: string;
+    description: string;
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    spec: {
+        kind: "prediction.v0";
+        oracle: {
+            venue: "chainlink-base-sepolia" | "chainlink-base";
+            feed: string;
+            feedDescription: string;
+        };
+        question: {
+            kind: "threshold";
+            threshold: string;
+            operator: "GT" | "GTE" | "LT" | "LTE";
+            resolveTs: number;
+        } | {
+            kind: "range";
+            resolveTs: number;
+            lowerBound: string;
+            upperBound: string;
+        };
+    };
+    eligibility?: {
+        maxSubmissionDelayMs?: number | undefined;
+    } | undefined;
+}>;
+export type PredictionV0Intent = z.infer<typeof PredictionV0IntentSchema>;
+export declare const PredictionSubmissionManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prediction.v0.submission.v1">;
+    generatedAt: z.ZodNumber;
+    intent: z.ZodObject<{
+        cid: z.ZodString;
+        onchainCreationTx: z.ZodString;
+        onchainCreationBlock: z.ZodNumber;
+        requestId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    }, {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    }>;
+    restorer: z.ZodObject<{
+        safeAddress: z.ZodString;
+        agentEoa: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        safeAddress: string;
+        agentEoa: string;
+    }, {
+        safeAddress: string;
+        agentEoa: string;
+    }>;
+    window: z.ZodObject<{
+        startTs: z.ZodNumber;
+        endTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startTs: number;
+        endTs: number;
+    }, {
+        startTs: number;
+        endTs: number;
+    }>;
+    prediction: z.ZodObject<{
+        probability: z.ZodString;
+        submittedAt: z.ZodNumber;
+        modelId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+    }, {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+    }>;
+    oracleSnapshot: z.ZodOptional<z.ZodObject<{
+        feed: z.ZodString;
+        roundId: z.ZodString;
+        answer: z.ZodString;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+    }, {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+    }>>;
+    rationale: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ts: z.ZodNumber;
+        note: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        ts: number;
+        note: string;
+    }, {
+        ts: number;
+        note: string;
+    }>, "many">>;
+    signature: z.ZodObject<{
+        algo: z.ZodLiteral<"secp256k1">;
+        signer: z.ZodString;
+        hash: z.ZodString;
+        sig: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    }, {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    schemaVersion: "prediction.v0.submission.v1";
+    generatedAt: number;
+    intent: {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    };
+    restorer: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    prediction: {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+    };
+    rationale?: {
+        ts: number;
+        note: string;
+    }[] | undefined;
+    oracleSnapshot?: {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+    } | undefined;
+}, {
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    schemaVersion: "prediction.v0.submission.v1";
+    generatedAt: number;
+    intent: {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    };
+    restorer: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    prediction: {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+    };
+    rationale?: {
+        ts: number;
+        note: string;
+    }[] | undefined;
+    oracleSnapshot?: {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+    } | undefined;
+}>;
+export type PredictionSubmissionManifest = z.infer<typeof PredictionSubmissionManifestSchema>;
+export declare const PredictionVerdictManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prediction.v0.verdict.v1">;
+    generatedAt: z.ZodNumber;
+    intent: z.ZodObject<{
+        cid: z.ZodString;
+        onchainCreationTx: z.ZodString;
+        onchainCreationBlock: z.ZodNumber;
+        requestId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    }, {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    }>;
+    evaluator: z.ZodObject<{
+        safeAddress: z.ZodString;
+        agentEoa: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        safeAddress: string;
+        agentEoa: string;
+    }, {
+        safeAddress: string;
+        agentEoa: string;
+    }>;
+    window: z.ZodObject<{
+        startTs: z.ZodNumber;
+        endTs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startTs: number;
+        endTs: number;
+    }, {
+        startTs: number;
+        endTs: number;
+    }>;
+    verdict: z.ZodEnum<["PASS", "FAIL", "REJECTED", "INDETERMINATE"]>;
+    score: z.ZodString;
+    scoreBasis: z.ZodLiteral<"brier.v1">;
+    scoreVersion: z.ZodString;
+    oracleReading: z.ZodObject<{
+        feed: z.ZodString;
+        roundId: z.ZodString;
+        answer: z.ZodString;
+        updatedAt: z.ZodNumber;
+        nextRoundUpdatedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+        nextRoundUpdatedAt?: number | undefined;
+    }, {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+        nextRoundUpdatedAt?: number | undefined;
+    }>;
+    claimed: z.ZodObject<{
+        probability: z.ZodString;
+        submittedAt: z.ZodNumber;
+        modelId: z.ZodString;
+        submissionManifestCid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+        submissionManifestCid: string;
+    }, {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+        submissionManifestCid: string;
+    }>;
+    groundTruth: z.ZodEnum<["YES", "NO"]>;
+    checks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<["PASS", "FAIL", "SKIP"]>;
+        detail: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: "PASS" | "FAIL" | "SKIP";
+        detail?: string | Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        status: "PASS" | "FAIL" | "SKIP";
+        detail?: string | Record<string, unknown> | undefined;
+    }>, "many">;
+    signature: z.ZodObject<{
+        algo: z.ZodLiteral<"secp256k1">;
+        signer: z.ZodString;
+        hash: z.ZodString;
+        sig: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    }, {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    schemaVersion: "prediction.v0.verdict.v1";
+    generatedAt: number;
+    intent: {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    };
+    evaluator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    verdict: "PASS" | "FAIL" | "REJECTED" | "INDETERMINATE";
+    score: string;
+    scoreBasis: "brier.v1";
+    scoreVersion: string;
+    claimed: {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+        submissionManifestCid: string;
+    };
+    checks: {
+        name: string;
+        status: "PASS" | "FAIL" | "SKIP";
+        detail?: string | Record<string, unknown> | undefined;
+    }[];
+    oracleReading: {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+        nextRoundUpdatedAt?: number | undefined;
+    };
+    groundTruth: "YES" | "NO";
+}, {
+    signature: {
+        hash: string;
+        algo: "secp256k1";
+        signer: string;
+        sig: string;
+    };
+    window: {
+        startTs: number;
+        endTs: number;
+    };
+    schemaVersion: "prediction.v0.verdict.v1";
+    generatedAt: number;
+    intent: {
+        cid: string;
+        onchainCreationTx: string;
+        onchainCreationBlock: number;
+        requestId: string;
+    };
+    evaluator: {
+        safeAddress: string;
+        agentEoa: string;
+    };
+    verdict: "PASS" | "FAIL" | "REJECTED" | "INDETERMINATE";
+    score: string;
+    scoreBasis: "brier.v1";
+    scoreVersion: string;
+    claimed: {
+        probability: string;
+        submittedAt: number;
+        modelId: string;
+        submissionManifestCid: string;
+    };
+    checks: {
+        name: string;
+        status: "PASS" | "FAIL" | "SKIP";
+        detail?: string | Record<string, unknown> | undefined;
+    }[];
+    oracleReading: {
+        feed: string;
+        roundId: string;
+        answer: string;
+        updatedAt: number;
+        nextRoundUpdatedAt?: number | undefined;
+    };
+    groundTruth: "YES" | "NO";
+}>;
+export type PredictionVerdictManifest = z.infer<typeof PredictionVerdictManifestSchema>;