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

package/dist/types/prediction-apy.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+import { WindowSchema } from './desired-state.js';
+const HexStringSchema = z.string().regex(/^0x[0-9a-fA-F]*$/, 'must be a 0x-prefixed hex string');
+const SignatureSchema = z.object({
+    algo: z.literal('secp256k1'),
+    signer: HexStringSchema,
+    hash: HexStringSchema,
+    sig: HexStringSchema,
+});
+const IntentProvenanceSchema = z.object({
+    cid: z.string().min(1),
+    onchainCreationTx: HexStringSchema,
+    onchainCreationBlock: z.number().int(),
+    requestId: HexStringSchema,
+});
+const ParticipantSchema = z.object({
+    safeAddress: HexStringSchema,
+    agentEoa: HexStringSchema,
+});
+const IntegerStringSchema = z.string().regex(/^-?\d+$/, 'must be an integer string');
+export const PredictionApyV0SpecSchema = z.object({
+    kind: z.literal('prediction.apy.v0'),
+    oracle: z.object({
+        venue: z.enum(['aave-v3-base-sepolia', 'aave-v3-base', 'aave-v3-mainnet']),
+        pool: HexStringSchema,
+        reserve: HexStringSchema,
+        reserveSymbol: z.string().min(1),
+    }),
+    metric: z.object({
+        type: z.literal('supply-apy-twa-bps'),
+        twaWindowSeconds: z.number().int().min(600).max(604_800),
+        sampleCount: z.number().int().min(2).max(512),
+        toleranceBps: z.number().int().min(1).max(10_000),
+    }),
+    question: z.object({
+        resolveTs: z.number().int(),
+    }),
+});
+export const PredictionApyV0EligibilitySchema = z.object({
+    /**
+     * Latest time after window start for a valid submission: submittedAt ≤
+     * startTs + maxSubmissionDelayMs. Default 72h so it does not cut off
+     * late-in-window posts on long windows; tighten per market.
+     */
+    maxSubmissionDelayMs: z.number().int().min(1).default(72 * 3_600_000),
+});
+export const PredictionApyV0IntentSchema = z
+    .object({
+    id: z.string(),
+    description: z.string().min(1),
+    window: WindowSchema,
+    spec: PredictionApyV0SpecSchema,
+    eligibility: PredictionApyV0EligibilitySchema.default({}),
+})
+    .refine((d) => d.window.endTs > d.window.startTs, {
+    message: 'window.endTs must be > window.startTs',
+    path: ['window'],
+})
+    .refine((d) => d.window.endTs - d.window.startTs >= 60_000, {
+    message: 'window must be at least 1 minute',
+    path: ['window'],
+})
+    .refine((d) => d.window.endTs - d.window.startTs <= 72 * 3_600_000, {
+    message: 'window must be at most 72 hours',
+    path: ['window'],
+})
+    .refine((d) => d.spec.question.resolveTs >= d.window.endTs, {
+    message: 'resolveTs must be ≥ window.endTs',
+    path: ['spec', 'question', 'resolveTs'],
+})
+    .refine((d) => d.spec.question.resolveTs - d.window.endTs <= 8 * 24 * 3_600_000, {
+    message: 'resolve gap must be ≤ 8 days',
+    path: ['spec', 'question', 'resolveTs'],
+})
+    .refine((d) => {
+    const { twaWindowSeconds, sampleCount } = d.spec.metric;
+    if (sampleCount < 2)
+        return true;
+    const stepMs = Math.floor((twaWindowSeconds * 1000) / (sampleCount - 1));
+    return stepMs >= 1000;
+}, {
+    message: 'TWA sample spacing must be at least 1 second (increase window or reduce sampleCount)',
+    path: ['spec', 'metric', 'sampleCount'],
+});
+export const PredictionApySubmissionManifestSchema = z.object({
+    schemaVersion: z.literal('prediction.apy.v0.submission.v1'),
+    generatedAt: z.number().int(),
+    intent: IntentProvenanceSchema,
+    restorer: ParticipantSchema,
+    window: WindowSchema,
+    prediction: z.object({
+        predictedBps: IntegerStringSchema,
+        submittedAt: z.number().int(),
+        modelId: z.string().min(1),
+    }),
+    signature: SignatureSchema,
+});
+export const PredictionApyVerdictManifestSchema = z.object({
+    schemaVersion: z.literal('prediction.apy.v0.verdict.v1'),
+    generatedAt: z.number().int(),
+    intent: IntentProvenanceSchema,
+    evaluator: ParticipantSchema,
+    window: WindowSchema,
+    verdict: z.enum(['PASS', 'FAIL', 'REJECTED', 'INDETERMINATE']),
+    score: z.string(),
+    scoreBasis: z.literal('absolute-error-linear.v1'),
+    scoreVersion: z.string(),
+    oracleReading: z.object({
+        pool: HexStringSchema,
+        reserve: HexStringSchema,
+        sampleCount: z.number().int().positive(),
+        twaWindowSeconds: z.number().int().positive(),
+        resolveTs: z.number().int(),
+    }),
+    claimed: z.object({
+        predictedBps: IntegerStringSchema,
+        submittedAt: z.number().int(),
+        modelId: z.string(),
+        /** Present when the submission was registered on IPFS; omitted for inline/dev. */
+        submissionManifestCid: z.string().min(1).optional(),
+    }),
+    groundTruth: z.object({
+        twApyBps: IntegerStringSchema,
+        errorBps: z.string().regex(/^\d+$/),
+    }),
+    checks: z.array(z.object({
+        name: z.string(),
+        status: z.enum(['PASS', 'FAIL', 'SKIP', 'INDETERMINATE']),
+        detail: z.union([z.string(), z.record(z.unknown())]).optional(),
+    })),
+    signature: SignatureSchema,
+});
+//# sourceMappingURL=prediction-apy.js.map

package/dist/types/prediction-apy.js.map

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