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

package/dist/types/portfolio.js

@@ -0,0 +1,168 @@
+/**
+ * portfolio.v0 — typed intent spec, restoration manifest, and verdict manifest.
+ *
+ * §4   portfolio.v0 concrete intent shape
+ * §5.1 Restoration manifest `portfolio.v0.manifest.v1`
+ * §5.2 Verdict manifest     `portfolio.v0.eval.manifest.v1`
+ */
+import { z } from 'zod';
+import { WindowSchema } from './desired-state.js';
+// ── Shared primitives ────────────────────────────────────────────────────────
+/** `0x`-prefixed hex string (address or tx hash). */
+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 SnapshotSchema = z.object({
+    capturedAt: z.number().int(),
+    hlTime: z.number().int(),
+    payload: z.unknown(),
+});
+// Evaluator's rederived snapshots don't carry hlTime — only the restorer captures it during the live window.
+const EvalSnapshotSchema = z.object({
+    capturedAt: z.number().int(),
+    payload: z.unknown(),
+});
+const ArtifactSchema = z.object({
+    cid: z.string().min(1),
+    // Open string — see §5.3 for conventions
+    role: z.string(),
+    sha256: z.string().optional(),
+    metadata: z.record(z.unknown()).optional(),
+    tags: z.array(z.string()).optional(),
+    access: z
+        .object({
+        kind: z.enum(['open', 'x402-gated']),
+        endpoint: z.string().optional(),
+        priceUsdc: z.string().optional(),
+    })
+        .optional(),
+});
+// ── §4.1 — portfolio.v0 intent spec ──────────────────────────────────────────
+export const PortfolioV0SpecSchema = z.object({
+    kind: z.literal('portfolio.v0'),
+    account: z.object({
+        venue: z.enum(['hyperliquid-testnet', 'hyperliquid-mainnet']),
+        masterAddress: HexStringSchema,
+    }),
+    target: z.object({
+        metric: z.literal('equity_return_pct'),
+        minReturnPct: z.number(),
+    }),
+    constraint: z.object({
+        maxDrawdownPct: z.number(),
+    }),
+});
+export const PortfolioV0EligibilitySchema = z.object({
+    minClosedTrades: z.number().int().default(20),
+    minTradedNotionalMultiple: z.number().default(5.0),
+});
+/**
+ * Full portfolio.v0 intent — composes the generic DesiredState fields with the
+ * portfolio-specific spec + eligibility fields.  The 24 h window constraint is
+ * enforced by a Zod refinement.
+ */
+export const PortfolioV0IntentSchema = z
+    .object({
+    // id is required here — generic DesiredState parsing assigns a UUID if missing; portfolio.v0 intents must already have one assigned.
+    id: z.string(),
+    description: z.string().min(1),
+    window: WindowSchema,
+    spec: PortfolioV0SpecSchema,
+    eligibility: PortfolioV0EligibilitySchema.default({}),
+})
+    .refine((d) => d.window.endTs - d.window.startTs === 86_400_000, {
+    message: 'window must be exactly 24 h (endTs - startTs === 86_400_000 ms)',
+    path: ['window'],
+});
+// ── §5.1 — Restoration manifest ──────────────────────────────────────────────
+const GatingSchema = z.object({
+    equityReturnPct: z.string(),
+    maxDrawdownPct: z.string(),
+    closedTradesCount: z.number().int(),
+    tradedNotionalMultiple: z.string(),
+});
+const InformationalSchema = z
+    .object({
+    sharpe: z.string().optional(),
+    sortino: z.string().optional(),
+    calmar: z.string().optional(),
+    profitFactor: z.string().optional(),
+    expectancy: z.string().optional(),
+    winRate: z.string().optional(),
+    holdTimeMs: z
+        .object({ mean: z.number(), median: z.number(), p95: z.number() })
+        .optional(),
+    leverageHistogram: z.record(z.number()).optional(),
+    longShortMix: z
+        .object({ longCount: z.number().int(), shortCount: z.number().int() })
+        .optional(),
+})
+    .optional();
+const RationaleEntrySchema = z.object({
+    ts: z.number().int(),
+    sessionId: z.string(),
+    note: z.string(),
+    relatedFillTids: z.array(z.number().int()).optional(),
+});
+export const RestorationManifestSchema = z.object({
+    schemaVersion: z.literal('portfolio.v0.manifest.v1'),
+    generatedAt: z.number().int(),
+    intent: IntentProvenanceSchema,
+    restorer: ParticipantSchema,
+    window: WindowSchema,
+    preSnapshot: SnapshotSchema,
+    postSnapshot: SnapshotSchema,
+    fills: z.array(z.unknown()),
+    gating: GatingSchema,
+    informational: InformationalSchema,
+    artifacts: z.array(ArtifactSchema),
+    rationale: z.array(RationaleEntrySchema).optional(),
+    signature: SignatureSchema,
+});
+// ── §5.2 — Verdict manifest ───────────────────────────────────────────────────
+const CheckSchema = z.object({
+    name: z.string(),
+    status: z.enum(['PASS', 'FAIL', 'SKIP']),
+    detail: z.union([z.string(), z.record(z.unknown())]).optional(),
+});
+export const VerdictManifestSchema = z.object({
+    schemaVersion: z.literal('portfolio.v0.eval.manifest.v1'),
+    generatedAt: z.number().int(),
+    intent: IntentProvenanceSchema,
+    evaluator: ParticipantSchema,
+    window: WindowSchema,
+    verdict: z.enum(['PASS', 'FAIL', 'REJECTED', 'INDETERMINATE']),
+    score: z.string(),
+    scoreBasis: z.string(),
+    scoreVersion: z.string(),
+    rederived: z.object({
+        preSnapshot: EvalSnapshotSchema,
+        postSnapshot: EvalSnapshotSchema,
+        fills: z.array(z.unknown()),
+        gating: z.record(z.unknown()),
+    }),
+    claimed: z.object({
+        preSnapshot: EvalSnapshotSchema,
+        postSnapshot: EvalSnapshotSchema,
+        fillsHash: z.string(),
+        fillsCount: z.number().int(),
+        gating: z.record(z.unknown()),
+    }),
+    checks: z.array(CheckSchema),
+    signature: SignatureSchema,
+});
+//# sourceMappingURL=portfolio.js.map

package/dist/types/portfolio.js.map

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