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

package/dist/restorer/impls/portfolio-v0-evaluator/checks/spec.js

@@ -0,0 +1,43 @@
+/**
+ * Spec checks for portfolio.v0.eval — §7.4.
+ *
+ * spec.equity_return_target
+ * spec.max_drawdown_constraint
+ *
+ * FAIL in any spec.* check → verdict FAIL per §7.3.
+ */
+// ── equity_return_target ──────────────────────────────────────────────────────
+/**
+ * Check that rederived equityReturnPct >= intent spec's minReturnPct.
+ */
+export function checkEquityReturnTarget(equityReturnPct, minReturnPct) {
+    if (equityReturnPct >= minReturnPct) {
+        return { name: 'spec.equity_return_target', status: 'PASS' };
+    }
+    return {
+        name: 'spec.equity_return_target',
+        status: 'FAIL',
+        detail: {
+            required: minReturnPct,
+            actual: equityReturnPct,
+        },
+    };
+}
+// ── max_drawdown_constraint ───────────────────────────────────────────────────
+/**
+ * Check that rederived maxDrawdownPct <= intent spec's maxDrawdownPct constraint.
+ */
+export function checkMaxDrawdownConstraint(maxDrawdownPct, maxAllowed) {
+    if (maxDrawdownPct <= maxAllowed) {
+        return { name: 'spec.max_drawdown_constraint', status: 'PASS' };
+    }
+    return {
+        name: 'spec.max_drawdown_constraint',
+        status: 'FAIL',
+        detail: {
+            limit: maxAllowed,
+            actual: maxDrawdownPct,
+        },
+    };
+}
+//# sourceMappingURL=spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/portfolio-v0-evaluator/checks/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,iFAAiF;AAEjF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,YAAoB;IAEpB,IAAI,eAAe,IAAI,YAAY,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,eAAe;SACxB;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,cAAsB,EACtB,UAAkB;IAElB,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,8BAA8B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,8BAA8B;QACpC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,cAAc;SACvB;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * portfolio-v0-evaluator — deterministic verifier for portfolio.v0 manifests.
+ *
+ * Implements RestorerImpl for spec.kind === "portfolio.v0" && type === "evaluation".
+ * No LLM. Pure deterministic verification per spec §7.
+ *
+ * Architecture decision (T7):
+ *   The engine (locked) builds portfolio.v0.manifest.v1. The verdict manifest
+ *   shape is portfolio.v0.eval.manifest.v1 (§5.2). Since the engine cannot be
+ *   modified, the eval impl assembles and signs the verdict manifest itself,
+ *   writes it as verdict.json in workingDir, and declares it as an artifact
+ *   with role "evaluation_verdict". The engine's outer manifest becomes the
+ *   packaging container; verdict.json is the meaningful payload.
+ *
+ * Unified-payload model (Task 7):
+ *   - spec.kind is "portfolio.v0" (same as restoration)
+ *   - intent.type === "evaluation"
+ *   - Restorer's manifest is inlined at intent.context.restorationResult (JSON string)
+ *   - Original intent spec is at intent.spec (PortfolioV0Spec) — no IPFS fetch needed
+ *   - intent.restorationRequestId carries the on-chain request ID
+ */
+import type { RestorerImpl, RestorationContext, RestorationOutput } from '../../types.js';
+import type { DesiredState } from '../../../types/desired-state.js';
+import type { PortfolioV0EvaluatorConfig } from './types.js';
+export declare class PortfolioV0Evaluator implements RestorerImpl {
+    readonly name = "portfolio-v0-evaluator";
+    readonly version = "1.0.0";
+    private readonly config;
+    constructor(config?: PortfolioV0EvaluatorConfig);
+    supports(ctx: {
+        kind: string;
+        type?: 'restoration' | 'evaluation';
+    }): boolean;
+    canAttempt(intent: DesiredState): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+    private _buildOutput;
+}
+export default PortfolioV0Evaluator;

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

@@ -0,0 +1,431 @@
+/**
+ * portfolio-v0-evaluator — deterministic verifier for portfolio.v0 manifests.
+ *
+ * Implements RestorerImpl for spec.kind === "portfolio.v0" && type === "evaluation".
+ * No LLM. Pure deterministic verification per spec §7.
+ *
+ * Architecture decision (T7):
+ *   The engine (locked) builds portfolio.v0.manifest.v1. The verdict manifest
+ *   shape is portfolio.v0.eval.manifest.v1 (§5.2). Since the engine cannot be
+ *   modified, the eval impl assembles and signs the verdict manifest itself,
+ *   writes it as verdict.json in workingDir, and declares it as an artifact
+ *   with role "evaluation_verdict". The engine's outer manifest becomes the
+ *   packaging container; verdict.json is the meaningful payload.
+ *
+ * Unified-payload model (Task 7):
+ *   - spec.kind is "portfolio.v0" (same as restoration)
+ *   - intent.type === "evaluation"
+ *   - Restorer's manifest is inlined at intent.context.restorationResult (JSON string)
+ *   - Original intent spec is at intent.spec (PortfolioV0Spec) — no IPFS fetch needed
+ *   - intent.restorationRequestId carries the on-chain request ID
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { keccak256 } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { HyperliquidClient, HL_MAINNET_BASE_URL, HL_TESTNET_BASE_URL } from '../../../venues/hyperliquid/client.js';
+import { bracketGridPoints } from '../../../venues/hyperliquid/grid.js';
+import { canonicalJson } from '../../engine/canonical-json.js';
+import { signCanonical } from '../../engine/signing.js';
+import { RestorationManifestSchema, PortfolioV0IntentSchema, PortfolioV0EligibilitySchema, } from '../../../types/portfolio.js';
+import { equityCurve, maxDrawdownPct as computeMaxDrawdownPct, equityReturnPct as computeEquityReturnPct, closedTradesCount as computeClosedTradesCount, tradedNotionalMultiple as computeTradedNotionalMultiple, } from './canonical-metrics.js';
+import { scoreCalmarV1 } from './score.js';
+import { checkHlReachable, checkPreSnapshotRederivable, checkFillsRederivable, checkPostSnapshotFundingAccrual, } from './checks/availability.js';
+import { checkMinClosedTrades, checkMinTradedNotional } from './checks/eligibility.js';
+import { checkWindowBounds } from './checks/integrity.js';
+import { checkPreSnapshot, checkPostSnapshot, checkFills, checkGatingEquityReturn, checkGatingMaxDrawdown, checkGatingClosedTrades, checkGatingTradedNotional, extractAccountValue, } from './checks/consistency.js';
+import { checkEquityReturnTarget, checkMaxDrawdownConstraint } from './checks/spec.js';
+// ── Verdict derivation per §7.3 ───────────────────────────────────────────────
+function deriveVerdict(checks) {
+    // if any "availability.*" FAIL → INDETERMINATE
+    const availFail = checks.some((c) => c.name.startsWith('availability.') && c.status === 'FAIL');
+    if (availFail)
+        return 'INDETERMINATE';
+    // if any "eligibility.*" FAIL → REJECTED
+    const eligFail = checks.some((c) => c.name.startsWith('eligibility.') && c.status === 'FAIL');
+    if (eligFail)
+        return 'REJECTED';
+    // if any "integrity.*"|"consistency.*"|"spec.*" FAIL → FAIL
+    const otherFail = checks.some((c) => (c.name.startsWith('integrity.') ||
+        c.name.startsWith('consistency.') ||
+        c.name.startsWith('spec.')) &&
+        c.status === 'FAIL');
+    if (otherFail)
+        return 'FAIL';
+    return 'PASS';
+}
+// ── Private helpers ───────────────────────────────────────────────────────────
+/**
+ * Assemble the unsigned verdict manifest object (no signature field).
+ *
+ * NOTE: `generatedAt` is intentionally excluded from this object.
+ * It is non-deterministic (wall-clock time) and MUST NOT be included
+ * in the signed content — two evaluations of the same inputs at different
+ * times must produce the same hash. `generatedAt` is added as an unsigned
+ * sibling field in _buildOutput after signing.
+ */
+function _assembleUnsignedManifest(params) {
+    const { intentCid, onchainCreationTx, onchainCreationBlock, restorationRequestId, intent, checks, verdict, score, targetManifest, rederivPrePayload, rederivFills, rederived, evaluatorSafeAddress, evaluatorAgentEoa, } = params;
+    const claimedGating = targetManifest?.gating ?? {
+        equityReturnPct: '0',
+        maxDrawdownPct: '0',
+        closedTradesCount: 0,
+        tradedNotionalMultiple: '0',
+    };
+    const intentProvenance = {
+        cid: intentCid,
+        onchainCreationTx: onchainCreationTx ?? '0x',
+        onchainCreationBlock: onchainCreationBlock,
+        requestId: restorationRequestId ?? '0x',
+    };
+    const rederivPreSnap = rederivPrePayload ?? {
+        capturedAt: targetManifest?.preSnapshot.capturedAt ?? 0,
+        payload: null,
+    };
+    const rederivPostSnap = {
+        capturedAt: targetManifest?.postSnapshot.capturedAt ?? 0,
+        payload: targetManifest?.postSnapshot.payload ?? null,
+    };
+    const fillsHash = (() => {
+        if (!rederivFills)
+            return '0x';
+        return keccak256(new TextEncoder().encode(canonicalJson(rederivFills)));
+    })();
+    return {
+        schemaVersion: 'portfolio.v0.eval.manifest.v1',
+        intent: intentProvenance,
+        evaluator: {
+            safeAddress: evaluatorSafeAddress,
+            agentEoa: evaluatorAgentEoa,
+        },
+        window: targetManifest?.window ?? intent.window ?? { startTs: 0, endTs: 0 },
+        verdict,
+        score,
+        scoreBasis: 'calmar.v1',
+        scoreVersion: 'v1',
+        rederived: {
+            preSnapshot: rederivPreSnap,
+            postSnapshot: rederivPostSnap,
+            fills: rederivFills ?? [],
+            gating: {
+                equityReturnPct: String(rederived?.equityReturn ?? 0),
+                maxDrawdownPct: String(rederived?.maxDrawdown ?? 0),
+                closedTradesCount: rederived?.closedTrades ?? 0,
+                tradedNotionalMultiple: String(rederived?.notional ?? 0),
+            },
+        },
+        claimed: {
+            preSnapshot: {
+                capturedAt: targetManifest?.preSnapshot.capturedAt ?? 0,
+                payload: targetManifest?.preSnapshot.payload ?? null,
+            },
+            postSnapshot: {
+                capturedAt: targetManifest?.postSnapshot.capturedAt ?? 0,
+                payload: targetManifest?.postSnapshot.payload ?? null,
+            },
+            fillsHash,
+            fillsCount: targetManifest?.fills.length ?? 0,
+            gating: claimedGating,
+        },
+        checks,
+    };
+}
+/**
+ * Sign the unsigned manifest or emit empty stub signature if no key or signing fails.
+ */
+async function _signOrStub(unsigned, privateKey, evaluatorAgentEoa, log) {
+    const stub = { hash: '0x', sig: '0x' };
+    if (!privateKey) {
+        return stub;
+    }
+    try {
+        const account = privateKeyToAccount(privateKey);
+        const signerAddr = evaluatorAgentEoa !== '0x0000000000000000000000000000000000000000'
+            ? evaluatorAgentEoa
+            : account.address;
+        const result = await signCanonical(unsigned, privateKey, signerAddr);
+        return { hash: result.hash, sig: result.sig };
+    }
+    catch (err) {
+        log({ level: 'warn', msg: 'portfolio-v0-evaluator: signing failed, emitting unsigned manifest', data: { err } });
+        return stub;
+    }
+}
+/**
+ * Write verdict manifest JSON to workingDir/verdict.json.
+ */
+function _writeVerdictArtifact(workingDir, verdictManifest) {
+    const verdictPath = join(workingDir, 'verdict.json');
+    writeFileSync(verdictPath, JSON.stringify(verdictManifest, null, 2), 'utf-8');
+}
+// ── PortfolioV0Evaluator ──────────────────────────────────────────────────────
+export class PortfolioV0Evaluator {
+    name = 'portfolio-v0-evaluator';
+    version = '1.0.0';
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.kind === 'portfolio.v0' && ctx.type === 'evaluation';
+    }
+    async canAttempt(intent) {
+        if (intent.spec?.kind !== 'portfolio.v0') {
+            return { ok: false, reason: 'spec.kind is not portfolio.v0' };
+        }
+        if (intent.type !== 'evaluation') {
+            return { ok: false, reason: 'DesiredState.type is not evaluation' };
+        }
+        if (!intent.restorationRequestId) {
+            return { ok: false, reason: 'restorationRequestId is required' };
+        }
+        const restorationResult = intent.context?.['restorationResult'];
+        if (typeof restorationResult !== 'string') {
+            return { ok: false, reason: 'context.restorationResult (manifest JSON) is required' };
+        }
+        return { ok: true };
+    }
+    async run(ctx) {
+        const { intent, log } = ctx;
+        // ── Step 1: Parse restorer's manifest from inlined context ────────────────
+        // The manifest JSON is inlined by MechAdapter.tryCreateEvaluationJob at context.restorationResult.
+        // Falls back to an error — crash recovery path not yet implemented.
+        let targetManifest;
+        let targetIntent;
+        let hlPortfolioPeriodFn;
+        let hlUserFillsByTimeFn;
+        const checks = [];
+        const inlined = intent.context?.['restorationResult'];
+        if (typeof inlined !== 'string') {
+            throw new Error('portfolio-v0-evaluator: restorationResult missing from context; crash recovery path not yet implemented');
+        }
+        try {
+            targetManifest = RestorationManifestSchema.parse(JSON.parse(inlined));
+            // The original portfolio.v0 intent is directly at intent.spec — no IPFS fetch needed.
+            targetIntent = PortfolioV0IntentSchema.parse(intent);
+            // Determine HL client from venue (or use injected test deps)
+            if (this.config._testDeps?.hlPortfolioPeriod && this.config._testDeps?.hlUserFillsByTime) {
+                hlPortfolioPeriodFn = this.config._testDeps.hlPortfolioPeriod;
+                hlUserFillsByTimeFn = this.config._testDeps.hlUserFillsByTime;
+            }
+            else {
+                const venue = targetIntent.spec.account.venue;
+                const baseUrl = venue === 'hyperliquid-mainnet' ? HL_MAINNET_BASE_URL : HL_TESTNET_BASE_URL;
+                const hlClient = new HyperliquidClient(baseUrl);
+                hlPortfolioPeriodFn = (user) => hlClient.portfolioPeriod(user, 'allTime');
+                hlUserFillsByTimeFn = (user, start, end) => hlClient.userFillsByTime(user, start, end);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log({ level: 'error', msg: 'portfolio-v0-evaluator: failed to parse manifest/intent', data: { err: msg } });
+            // We cannot proceed — return a minimal INDETERMINATE output.
+            checks.push({
+                name: 'availability.manifest_parseable',
+                status: 'FAIL',
+                detail: `Failed to parse manifest or intent: ${msg}`,
+            });
+            return this._buildOutput(ctx, checks, null, null, null, null, null, null, null, null);
+        }
+        // Extract provenance fields from the parsed manifest + intent
+        const intentCid = targetManifest.intent.cid;
+        const onchainCreationTx = targetManifest.intent.onchainCreationTx;
+        const onchainCreationBlock = targetManifest.intent.onchainCreationBlock;
+        const restorationRequestId = intent.restorationRequestId;
+        log({ level: 'info', msg: 'portfolio-v0-evaluator: starting evaluation', data: { intentCid, restorationRequestId } });
+        const masterAddress = targetIntent.spec.account.masterAddress;
+        const { startTs, endTs } = targetManifest.window;
+        // ── Step 2: Re-fetch HL data ──────────────────────────────────────────────
+        // 2a: Check HL reachability + fetch portfolio grid + fills
+        let grid = [];
+        let rederivFills = [];
+        let startTimeClamped = false;
+        let hlReachable = false;
+        try {
+            const [portfolioResp, fillsResult] = await Promise.all([
+                hlPortfolioPeriodFn(masterAddress),
+                hlUserFillsByTimeFn(masterAddress, startTs, endTs),
+            ]);
+            grid = portfolioResp?.accountValueHistory ?? [];
+            rederivFills = fillsResult.fills;
+            startTimeClamped = fillsResult.startTimeClamped;
+            hlReachable = true;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log({ level: 'error', msg: 'portfolio-v0-evaluator: HL API call failed', data: { err: msg } });
+        }
+        // ── Availability checks ───────────────────────────────────────────────────
+        checks.push(checkHlReachable(hlReachable));
+        if (!hlReachable) {
+            return this._buildOutput(ctx, checks, null, null, null, null, intentCid, onchainCreationTx, onchainCreationBlock, restorationRequestId);
+        }
+        const preCapturedAt = targetManifest.preSnapshot.capturedAt;
+        const postCapturedAt = targetManifest.postSnapshot.capturedAt;
+        checks.push(checkPreSnapshotRederivable(grid, preCapturedAt));
+        checks.push(checkFillsRederivable(startTimeClamped));
+        const postAccrualCheck = checkPostSnapshotFundingAccrual(postCapturedAt, endTs);
+        checks.push(postAccrualCheck);
+        // If post-snapshot funding accrual SKIP → downstream consistency is skipped
+        const skipPostConsistency = postAccrualCheck.status === 'SKIP';
+        // ── Derive pre-snapshot from grid ─────────────────────────────────────────
+        const bracket = bracketGridPoints(grid, preCapturedAt);
+        let rederivPrePayload = null;
+        if (bracket !== null) {
+            // Interpolate accountValue at preCapturedAt between the two bracket points
+            const [beforeTs, beforeVal] = bracket.before;
+            const [afterTs, afterVal] = bracket.after;
+            const frac = afterTs > beforeTs ? (preCapturedAt - beforeTs) / (afterTs - beforeTs) : 0;
+            const interpolatedValue = parseFloat(beforeVal) + frac * (parseFloat(afterVal) - parseFloat(beforeVal));
+            rederivPrePayload = {
+                capturedAt: preCapturedAt,
+                payload: {
+                    marginSummary: { accountValue: String(interpolatedValue) },
+                },
+            };
+        }
+        // ── Derive post-snapshot ───────────────────────────────────────────────────
+        // For the post-snapshot, we use the claimed value (from the manifest) since
+        // HL only returns current state. The §7.7 note says to use the portfolio grid
+        // for the pre-snapshot only. For post-snapshot we compare against the live
+        // clearinghouse state at the time of evaluation — but since we're post-window,
+        // the best we can do is compare fill-derived metrics.
+        //
+        // To keep things deterministic: rederived post snapshot = claimed post snapshot
+        // (we verify internal consistency of the manifest, not post re-fetch).
+        const rederivPostPayload = skipPostConsistency
+            ? null
+            : {
+                capturedAt: postCapturedAt,
+                payload: targetManifest.postSnapshot.payload,
+            };
+        // ── Compute canonical metrics ─────────────────────────────────────────────
+        // Extract accountValues for metric computation
+        const claimedPrePayload = targetManifest.preSnapshot.payload;
+        const claimedPostPayload = targetManifest.postSnapshot.payload;
+        // Use the shared extractor so unified-shape and legacy payloads both work
+        // (see `extractAccountValue` in checks/consistency.ts).
+        const preValue = (rederivPrePayload ? extractAccountValue(rederivPrePayload.payload) : null)
+            ?? extractAccountValue(claimedPrePayload)
+            ?? 0;
+        const postValue = extractAccountValue(claimedPostPayload) ?? 0;
+        const fillTimes = rederivFills.map((f) => f.time);
+        const curve = equityCurve(preCapturedAt, preValue, postCapturedAt, postValue, fillTimes);
+        const rederivEquityReturn = computeEquityReturnPct(preValue, postValue);
+        const rederivMaxDrawdown = computeMaxDrawdownPct(curve);
+        const rederivClosedTrades = computeClosedTradesCount(rederivFills);
+        const rederivNotional = computeTradedNotionalMultiple(rederivFills, preValue);
+        // ── Integrity checks ──────────────────────────────────────────────────────
+        checks.push(checkWindowBounds(preCapturedAt, postCapturedAt, startTs, endTs));
+        // ── Eligibility checks ────────────────────────────────────────────────────
+        const eligibility = PortfolioV0EligibilitySchema.parse(targetIntent.eligibility ?? {});
+        checks.push(checkMinClosedTrades(rederivClosedTrades, eligibility.minClosedTrades));
+        checks.push(checkMinTradedNotional(rederivNotional, eligibility.minTradedNotionalMultiple));
+        // ── Consistency checks ────────────────────────────────────────────────────
+        const claimedGating = targetManifest.gating;
+        checks.push(checkPreSnapshot(claimedPrePayload, rederivPrePayload));
+        checks.push(checkPostSnapshot(claimedPostPayload, rederivPostPayload));
+        checks.push(checkFills(targetManifest.fills, rederivFills));
+        checks.push(checkGatingEquityReturn(claimedGating.equityReturnPct, rederivEquityReturn));
+        checks.push(checkGatingMaxDrawdown(claimedGating.maxDrawdownPct, rederivMaxDrawdown));
+        checks.push(checkGatingClosedTrades(claimedGating.closedTradesCount, rederivClosedTrades));
+        checks.push(checkGatingTradedNotional(claimedGating.tradedNotionalMultiple, rederivNotional));
+        // ── Spec checks ───────────────────────────────────────────────────────────
+        checks.push(checkEquityReturnTarget(rederivEquityReturn, targetIntent.spec.target.minReturnPct));
+        checks.push(checkMaxDrawdownConstraint(rederivMaxDrawdown, targetIntent.spec.constraint.maxDrawdownPct));
+        // ── Derive verdict ────────────────────────────────────────────────────────
+        const rederived = {
+            equityReturn: rederivEquityReturn,
+            maxDrawdown: rederivMaxDrawdown,
+            closedTrades: rederivClosedTrades,
+            notional: rederivNotional,
+        };
+        return this._buildOutput(ctx, checks, targetManifest, rederivPrePayload, rederivFills, rederived, intentCid, onchainCreationTx, onchainCreationBlock, restorationRequestId);
+    }
+    async _buildOutput(ctx, checks, targetManifest, rederivPrePayload, rederivFills, rederived, intentCid, onchainCreationTx, onchainCreationBlock, restorationRequestId) {
+        const { intent, workingDir, log } = ctx;
+        // Spec §7.5 funding-accrual edge case: if hl_post_snapshot_rederivable is SKIP,
+        // the verdict MUST be INDETERMINATE regardless of other check outcomes.
+        // (deriveVerdict() only handles FAIL→INDETERMINATE per §7.3; SKIP needs explicit handling.)
+        const postRederivableSkipped = checks.some((c) => c.name === 'availability.hl_post_snapshot_rederivable' && c.status === 'SKIP');
+        const verdict = postRederivableSkipped ? 'INDETERMINATE' : deriveVerdict(checks);
+        const equityReturn = rederived?.equityReturn ?? 0;
+        const maxDrawdown = rederived?.maxDrawdown ?? 0;
+        const score = scoreCalmarV1(equityReturn, maxDrawdown, verdict);
+        log({ level: 'info', msg: 'portfolio-v0-evaluator: verdict derived', data: { verdict, score, checkCount: checks.length } });
+        // Evaluator identity — sourced from constructor config (injected by daemon)
+        const evaluatorSafeAddress = (this.config.safeAddress ?? '0x0000000000000000000000000000000000000000');
+        const evaluatorAgentEoa = (this.config.agentEoa ?? '0x0000000000000000000000000000000000000000');
+        // ── Assemble unsigned verdict manifest ────────────────────────────────────
+        // generatedAt is NOT included in the signed content: it is non-deterministic
+        // (wall-clock) and must not affect the hash. It is added below after signing.
+        const unsigned = _assembleUnsignedManifest({
+            intentCid: intentCid ?? '',
+            onchainCreationTx: onchainCreationTx ?? '0x',
+            onchainCreationBlock: onchainCreationBlock ?? 0,
+            restorationRequestId: restorationRequestId ?? '0x',
+            intent,
+            checks,
+            verdict,
+            score,
+            targetManifest,
+            rederivPrePayload,
+            rederivFills,
+            rederived,
+            evaluatorSafeAddress,
+            evaluatorAgentEoa,
+        });
+        // ── Sign or emit stub ─────────────────────────────────────────────────────
+        const privateKey = this.config.agentEoaPrivateKey;
+        const { hash, sig } = await _signOrStub(unsigned, privateKey, evaluatorAgentEoa, log);
+        // generatedAt: unsigned metadata — sits outside the signed envelope.
+        // Added after signing so it does not influence the hash.
+        const generatedAt = Date.now();
+        const verdictManifest = {
+            ...unsigned,
+            generatedAt,
+            signature: {
+                algo: 'secp256k1',
+                signer: evaluatorAgentEoa,
+                hash,
+                sig,
+            },
+        };
+        // ── Write verdict.json ────────────────────────────────────────────────────
+        _writeVerdictArtifact(workingDir, verdictManifest);
+        log({ level: 'info', msg: 'portfolio-v0-evaluator: verdict.json written', data: { path: join(workingDir, 'verdict.json') } });
+        // ── Build RestorationOutput ───────────────────────────────────────────────
+        const output = {
+            venueRef: { name: 'hyperliquid' },
+            gating: {
+                verdict,
+                score,
+                scoreBasis: 'calmar.v1',
+                scoreVersion: 'v1',
+                checkCount: checks.length,
+                passCount: checks.filter((c) => c.status === 'PASS').length,
+                failCount: checks.filter((c) => c.status === 'FAIL').length,
+                skipCount: checks.filter((c) => c.status === 'SKIP').length,
+            },
+            informational: {
+                intentCid: intentCid ?? '',
+                equityReturnPct: String(rederived?.equityReturn ?? 0),
+                maxDrawdownPct: String(rederived?.maxDrawdown ?? 0),
+                closedTradesCount: rederived?.closedTrades ?? 0,
+                tradedNotionalMultiple: String(rederived?.notional ?? 0),
+            },
+            artifacts: [
+                {
+                    path: 'verdict.json',
+                    role: 'evaluation_verdict',
+                    metadata: { verdict, score, schemaVersion: 'portfolio.v0.eval.manifest.v1' },
+                    tags: ['verdict', 'evaluation'],
+                    access: { kind: 'open' },
+                },
+            ],
+        };
+        return output;
+    }
+}
+export default PortfolioV0Evaluator;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Score function for portfolio.v0 evaluation — §7.8.
+ *
+ * scoreBasis: "calmar.v1"
+ * score_calmar_v1 =
+ *   if verdict != PASS: "0"
+ *   else:
+ *     ratio = clamp(equityReturnPct / max(maxDrawdownPct, 1.0%), 0, 10.0)
+ *     encoded = ratio * 1e17   // range [0, 1e18]
+ *     encoded as decimal string
+ */
+import type { Verdict } from './types.js';
+/**
+ * Compute the calmar.v1 score.
+ *
+ * @param equityReturnPct  Equity return percentage (e.g. 5.0 for +5%)
+ * @param maxDrawdownPctVal  Max drawdown percentage (e.g. 2.0 for 2%)
+ * @param verdict  The evaluation verdict
+ * @returns Fixed-point string in 1e18 scale; "0" for any non-PASS verdict
+ */
+export declare function scoreCalmarV1(equityReturnPct: number, maxDrawdownPctVal: number, verdict: Verdict): string;

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

@@ -0,0 +1,32 @@
+/**
+ * Score function for portfolio.v0 evaluation — §7.8.
+ *
+ * scoreBasis: "calmar.v1"
+ * score_calmar_v1 =
+ *   if verdict != PASS: "0"
+ *   else:
+ *     ratio = clamp(equityReturnPct / max(maxDrawdownPct, 1.0%), 0, 10.0)
+ *     encoded = ratio * 1e17   // range [0, 1e18]
+ *     encoded as decimal string
+ */
+/**
+ * Compute the calmar.v1 score.
+ *
+ * @param equityReturnPct  Equity return percentage (e.g. 5.0 for +5%)
+ * @param maxDrawdownPctVal  Max drawdown percentage (e.g. 2.0 for 2%)
+ * @param verdict  The evaluation verdict
+ * @returns Fixed-point string in 1e18 scale; "0" for any non-PASS verdict
+ */
+export function scoreCalmarV1(equityReturnPct, maxDrawdownPctVal, verdict) {
+    if (verdict !== 'PASS') {
+        return '0';
+    }
+    const denominator = Math.max(maxDrawdownPctVal, 1.0);
+    const ratio = Math.min(Math.max(equityReturnPct / denominator, 0), 10.0);
+    // ratio * 1e17 → range [0, 1e18]
+    // Use BigInt arithmetic to avoid floating-point precision loss in the
+    // fixed-point representation.
+    const ratioBig = BigInt(Math.round(ratio * 1e17));
+    return ratioBig.toString();
+}
+//# sourceMappingURL=score.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../../src/restorer/impls/portfolio-v0-evaluator/score.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,eAAuB,EACvB,iBAAyB,EACzB,OAAgB;IAEhB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAEzE,iCAAiC;IACjC,sEAAsE;IACtE,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IAElD,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+import type { HlFill, HlGridPoint } from '../../../venues/hyperliquid/types.js';
+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';
+export interface PortfolioV0EvaluatorConfig {
+    /** Evaluator Safe multisig address (injected by daemon). */
+    safeAddress?: string;
+    /** Evaluator agent EOA address (injected by daemon). */
+    agentEoa?: string;
+    /** Evaluator agent EOA private key (injected by daemon). */
+    agentEoaPrivateKey?: string;
+    /** Test-only: injectable deps to avoid real network calls. */
+    _testDeps?: {
+        hlPortfolioPeriod?: (user: string) => Promise<{
+            accountValueHistory: HlGridPoint[];
+        } | null>;
+        hlUserFillsByTime?: (user: string, startTime: number, endTime?: number) => Promise<{
+            fills: HlFill[];
+            startTimeClamped: boolean;
+        }>;
+    };
+}