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

package/dist/types/prediction.js

@@ -0,0 +1,140 @@
+/**
+ * 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';
+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,
+});
+// ── Question kinds ────────────────────────────────────────────────────────────
+const ThresholdQuestionSchema = z.object({
+    kind: z.literal('threshold'),
+    operator: z.enum(['GT', 'GTE', 'LT', 'LTE']),
+    threshold: z.string(),
+    resolveTs: z.number().int(),
+});
+const RangeQuestionSchema = z.object({
+    kind: z.literal('range'),
+    lowerBound: z.string(),
+    upperBound: z.string(),
+    resolveTs: z.number().int(),
+});
+// ── Spec + eligibility + intent ────────────────────────────────────────────────
+export const PredictionV0SpecSchema = z.object({
+    kind: z.literal('prediction.v0'),
+    oracle: z.object({
+        venue: z.enum(['chainlink-base-sepolia', 'chainlink-base']),
+        feed: HexStringSchema,
+        feedDescription: z.string(),
+    }),
+    question: z.discriminatedUnion('kind', [ThresholdQuestionSchema, RangeQuestionSchema]),
+});
+export const PredictionV0EligibilitySchema = z.object({
+    maxSubmissionDelayMs: z.number().int().default(60_000),
+});
+export const PredictionV0IntentSchema = z
+    .object({
+    id: z.string(),
+    description: z.string().min(1),
+    window: WindowSchema,
+    spec: PredictionV0SpecSchema,
+    eligibility: PredictionV0EligibilitySchema.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 <= 86_400_000, {
+    message: 'window must be at most 24 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 <= 3_600_000, {
+    message: 'resolve gap (resolveTs - endTs) must be ≤ 1 hour',
+    path: ['spec', 'question', 'resolveTs'],
+});
+// ── Submission manifest ───────────────────────────────────────────────────────
+export const PredictionSubmissionManifestSchema = z.object({
+    schemaVersion: z.literal('prediction.v0.submission.v1'),
+    generatedAt: z.number().int(),
+    intent: IntentProvenanceSchema,
+    restorer: ParticipantSchema,
+    window: WindowSchema,
+    prediction: z.object({
+        probability: z.string().regex(/^(0(\.\d+)?|1(\.0+)?)$/, 'must be a decimal in [0,1]'),
+        submittedAt: z.number().int(),
+        modelId: z.string().min(1),
+    }),
+    oracleSnapshot: z
+        .object({
+        feed: HexStringSchema,
+        roundId: z.string(),
+        answer: z.string(),
+        updatedAt: z.number().int(),
+    })
+        .optional(),
+    rationale: z
+        .array(z.object({
+        ts: z.number().int(),
+        note: z.string(),
+    }))
+        .optional(),
+    signature: SignatureSchema,
+});
+// ── 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 PredictionVerdictManifestSchema = z.object({
+    schemaVersion: z.literal('prediction.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('brier.v1'),
+    scoreVersion: z.string(),
+    oracleReading: z.object({
+        feed: HexStringSchema,
+        roundId: z.string(),
+        answer: z.string(),
+        updatedAt: z.number().int(),
+        nextRoundUpdatedAt: z.number().int().optional(),
+    }),
+    claimed: z.object({
+        probability: z.string(),
+        submittedAt: z.number().int(),
+        modelId: z.string(),
+        submissionManifestCid: z.string(),
+    }),
+    groundTruth: z.enum(['YES', 'NO']),
+    checks: z.array(CheckSchema),
+    signature: SignatureSchema,
+});
+//# sourceMappingURL=prediction.js.map

package/dist/types/prediction.js.map

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

package/dist/venues/aave-v3/addresses.d.ts

@@ -0,0 +1,6 @@
+export interface AaveReserveAddressSet {
+    pool: `0x${string}`;
+    reserve: `0x${string}`;
+    symbol: string;
+}
+export declare const AAVE_V3_USDC: Record<'aave-v3-base-sepolia' | 'aave-v3-base' | 'aave-v3-mainnet', AaveReserveAddressSet>;

package/dist/venues/aave-v3/addresses.js

@@ -0,0 +1,19 @@
+export const AAVE_V3_USDC = {
+    'aave-v3-base-sepolia': {
+        // Base Sepolia pool proxy + USDC reserve (Aave v3 test deployment).
+        pool: '0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951',
+        reserve: '0x31d3A7711a10C45D72649D51E1c8D74282702572',
+        symbol: 'USDC',
+    },
+    'aave-v3-base': {
+        pool: '0xA238Dd80C259a72e81d7e4664a9801593F98d1c5',
+        reserve: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        symbol: 'USDC',
+    },
+    'aave-v3-mainnet': {
+        pool: '0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2',
+        reserve: '0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+        symbol: 'USDC',
+    },
+};
+//# sourceMappingURL=addresses.js.map

package/dist/venues/aave-v3/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../src/venues/aave-v3/addresses.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,YAAY,GAA+F;IACtH,sBAAsB,EAAE;QACtB,oEAAoE;QACpE,IAAI,EAAE,4CAA4C;QAClD,OAAO,EAAE,4CAA4C;QACrD,MAAM,EAAE,MAAM;KACf;IACD,cAAc,EAAE;QACd,IAAI,EAAE,4CAA4C;QAClD,OAAO,EAAE,4CAA4C;QACrD,MAAM,EAAE,MAAM;KACf;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,4CAA4C;QAClD,OAAO,EAAE,4CAA4C;QACrD,MAAM,EAAE,MAAM;KACf;CACF,CAAC"}

package/dist/venues/aave-v3/client.d.ts

@@ -0,0 +1,81 @@
+import type { PublicClient } from 'viem';
+export declare const AAVE_POOL_ABI: readonly [{
+    readonly name: "getReserveData";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "asset";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "configuration";
+        readonly type: "uint256";
+    }, {
+        readonly name: "liquidityIndex";
+        readonly type: "uint128";
+    }, {
+        readonly name: "currentLiquidityRate";
+        readonly type: "uint128";
+    }, {
+        readonly name: "variableBorrowIndex";
+        readonly type: "uint128";
+    }, {
+        readonly name: "currentVariableBorrowRate";
+        readonly type: "uint128";
+    }, {
+        readonly name: "currentStableBorrowRate";
+        readonly type: "uint128";
+    }, {
+        readonly name: "lastUpdateTimestamp";
+        readonly type: "uint40";
+    }, {
+        readonly name: "id";
+        readonly type: "uint16";
+    }, {
+        readonly name: "aTokenAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "stableDebtTokenAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "variableDebtTokenAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "interestRateStrategyAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "accruedToTreasury";
+        readonly type: "uint128";
+    }, {
+        readonly name: "unbacked";
+        readonly type: "uint128";
+    }, {
+        readonly name: "isolationModeTotalDebt";
+        readonly type: "uint128";
+    }];
+}];
+export interface ReserveRateReading {
+    blockNumber: bigint;
+    blockTimestampMs: number;
+    currentLiquidityRateRay: bigint;
+}
+export interface TwaApyBpsResult {
+    twApyBps: number;
+    sampleCount: number;
+    sampleTimestampsMs: number[];
+}
+export declare function scheduleSampleTimestamps(windowEndTs: number, twaWindowSeconds: number, sampleCount: number): number[];
+export declare function liquidityRateRayToApyBps(rateRay: bigint): number;
+export declare function findBlockAtOrBeforeTimestamp(publicClient: PublicClient, targetTsMs: number): Promise<{
+    number: bigint;
+    timestampMs: number;
+}>;
+export declare function readReserveRateAtTimestamp(publicClient: PublicClient, pool: `0x${string}`, reserve: `0x${string}`, timestampMs: number): Promise<ReserveRateReading>;
+export declare function twApyBpsOverWindow(params: {
+    publicClient: PublicClient;
+    pool: `0x${string}`;
+    reserve: `0x${string}`;
+    windowEndTs: number;
+    twaWindowSeconds: number;
+    sampleCount: number;
+}): Promise<TwaApyBpsResult>;

package/dist/venues/aave-v3/client.js

@@ -0,0 +1,97 @@
+export const AAVE_POOL_ABI = [
+    {
+        name: 'getReserveData',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'asset', type: 'address' }],
+        outputs: [
+            { name: 'configuration', type: 'uint256' },
+            { name: 'liquidityIndex', type: 'uint128' },
+            { name: 'currentLiquidityRate', type: 'uint128' },
+            { name: 'variableBorrowIndex', type: 'uint128' },
+            { name: 'currentVariableBorrowRate', type: 'uint128' },
+            { name: 'currentStableBorrowRate', type: 'uint128' },
+            { name: 'lastUpdateTimestamp', type: 'uint40' },
+            { name: 'id', type: 'uint16' },
+            { name: 'aTokenAddress', type: 'address' },
+            { name: 'stableDebtTokenAddress', type: 'address' },
+            { name: 'variableDebtTokenAddress', type: 'address' },
+            { name: 'interestRateStrategyAddress', type: 'address' },
+            { name: 'accruedToTreasury', type: 'uint128' },
+            { name: 'unbacked', type: 'uint128' },
+            { name: 'isolationModeTotalDebt', type: 'uint128' },
+        ],
+    },
+];
+const RAY = 10n ** 27n;
+const SECONDS_PER_YEAR = 31536000n;
+export function scheduleSampleTimestamps(windowEndTs, twaWindowSeconds, sampleCount) {
+    if (sampleCount < 2)
+        throw new Error('sampleCount must be >= 2');
+    const windowMs = twaWindowSeconds * 1000;
+    const start = windowEndTs - windowMs;
+    if (start < 0)
+        throw new Error('twa window starts before unix epoch');
+    const step = Math.floor(windowMs / (sampleCount - 1));
+    if (step <= 0)
+        throw new Error('sample spacing must be positive');
+    const ts = [];
+    for (let i = 0; i < sampleCount; i++)
+        ts.push(start + i * step);
+    ts[ts.length - 1] = windowEndTs;
+    return ts;
+}
+export function liquidityRateRayToApyBps(rateRay) {
+    const apr = Number(rateRay) / Number(RAY);
+    const apy = Math.pow(1 + apr / Number(SECONDS_PER_YEAR), Number(SECONDS_PER_YEAR)) - 1;
+    return Math.round(apy * 10_000);
+}
+export async function findBlockAtOrBeforeTimestamp(publicClient, targetTsMs) {
+    const latest = await publicClient.getBlock({ blockTag: 'latest' });
+    let lo = 0n;
+    let hi = latest.number;
+    let best = 0n;
+    while (lo <= hi) {
+        const mid = (lo + hi) / 2n;
+        const block = await publicClient.getBlock({ blockNumber: mid });
+        const tsMs = Number(block.timestamp) * 1000;
+        if (tsMs <= targetTsMs) {
+            best = mid;
+            lo = mid + 1n;
+        }
+        else {
+            hi = mid - 1n;
+        }
+    }
+    const b = await publicClient.getBlock({ blockNumber: best });
+    return { number: b.number, timestampMs: Number(b.timestamp) * 1000 };
+}
+export async function readReserveRateAtTimestamp(publicClient, pool, reserve, timestampMs) {
+    const block = await findBlockAtOrBeforeTimestamp(publicClient, timestampMs);
+    const reserveData = await publicClient.readContract({
+        address: pool,
+        abi: AAVE_POOL_ABI,
+        functionName: 'getReserveData',
+        args: [reserve],
+        blockNumber: block.number,
+    });
+    return {
+        blockNumber: block.number,
+        blockTimestampMs: block.timestampMs,
+        currentLiquidityRateRay: reserveData[2],
+    };
+}
+export async function twApyBpsOverWindow(params) {
+    const sampleTs = scheduleSampleTimestamps(params.windowEndTs, params.twaWindowSeconds, params.sampleCount);
+    let sum = 0;
+    for (const ts of sampleTs) {
+        const r = await readReserveRateAtTimestamp(params.publicClient, params.pool, params.reserve, ts);
+        sum += liquidityRateRayToApyBps(r.currentLiquidityRateRay);
+    }
+    return {
+        twApyBps: Math.round(sum / sampleTs.length),
+        sampleCount: sampleTs.length,
+        sampleTimestampsMs: sampleTs,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/venues/aave-v3/client.js.map

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

package/dist/venues/chainlink/client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Chainlink AggregatorV3 read client.
+ *
+ * §7 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
+ */
+import type { PublicClient } from 'viem';
+export declare const AGGREGATOR_V3_ABI: readonly [{
+    readonly name: "latestRoundData";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "roundId";
+        readonly type: "uint80";
+    }, {
+        readonly name: "answer";
+        readonly type: "int256";
+    }, {
+        readonly name: "startedAt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "updatedAt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "answeredInRound";
+        readonly type: "uint80";
+    }];
+}, {
+    readonly name: "getRoundData";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "_roundId";
+        readonly type: "uint80";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "roundId";
+        readonly type: "uint80";
+    }, {
+        readonly name: "answer";
+        readonly type: "int256";
+    }, {
+        readonly name: "startedAt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "updatedAt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "answeredInRound";
+        readonly type: "uint80";
+    }];
+}, {
+    readonly name: "decimals";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+}, {
+    readonly name: "description";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+}];
+export interface RoundReading {
+    roundId: bigint;
+    answer: bigint;
+    startedAt: number;
+    updatedAt: number;
+    answeredInRound: bigint;
+    decimals: number;
+}
+/** Scale a raw Chainlink int256 answer to a decimal string. */
+export declare function scaleToDecimal(answer: bigint, decimals: number): string;
+export declare function readChainlinkLatest(feed: `0x${string}`, publicClient: PublicClient): Promise<RoundReading>;
+export declare function readChainlinkRound(feed: `0x${string}`, roundId: bigint, publicClient: PublicClient, decimals: number): Promise<RoundReading>;
+export interface SpanningResult {
+    /** Round R with updatedAt ≤ resolveTs. */
+    round: RoundReading;
+    /** Round R+1 with updatedAt > resolveTs. null if no newer round exists yet. */
+    nextRound: RoundReading | null;
+    /** True iff nextRound exists — then the spanning property is satisfied. */
+    spanning: boolean;
+}
+/**
+ * Find the Chainlink round that "spans" resolveTs: round R where
+ * R.updatedAt ≤ resolveTs < (R+1).updatedAt.
+ *
+ * If the latest round's updatedAt ≤ resolveTs (i.e. no newer round yet),
+ * returns { round: latest, nextRound: null, spanning: false }. Caller should
+ * retry later (availability check will mark SKIP → INDETERMINATE verdict).
+ */
+export declare function oraclePriceAtResolveTs(feed: `0x${string}`, resolveTs: number, publicClient: PublicClient): Promise<SpanningResult>;

package/dist/venues/chainlink/client.js

@@ -0,0 +1,130 @@
+export const AGGREGATOR_V3_ABI = [
+    {
+        name: 'latestRoundData',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [
+            { name: 'roundId', type: 'uint80' },
+            { name: 'answer', type: 'int256' },
+            { name: 'startedAt', type: 'uint256' },
+            { name: 'updatedAt', type: 'uint256' },
+            { name: 'answeredInRound', type: 'uint80' },
+        ],
+    },
+    {
+        name: 'getRoundData',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: '_roundId', type: 'uint80' }],
+        outputs: [
+            { name: 'roundId', type: 'uint80' },
+            { name: 'answer', type: 'int256' },
+            { name: 'startedAt', type: 'uint256' },
+            { name: 'updatedAt', type: 'uint256' },
+            { name: 'answeredInRound', type: 'uint80' },
+        ],
+    },
+    {
+        name: 'decimals',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint8' }],
+    },
+    {
+        name: 'description',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'string' }],
+    },
+];
+/** Scale a raw Chainlink int256 answer to a decimal string. */
+export function scaleToDecimal(answer, decimals) {
+    if (answer < 0n) {
+        throw new Error(`scaleToDecimal: negative value not supported in v0 (got ${answer})`);
+    }
+    const s = answer.toString();
+    if (decimals === 0)
+        return s;
+    if (s.length <= decimals) {
+        const frac = s.padStart(decimals, '0').replace(/0+$/, '');
+        return frac.length > 0 ? `0.${frac}` : '0';
+    }
+    const intPart = s.slice(0, s.length - decimals);
+    const fracRaw = s.slice(s.length - decimals);
+    const frac = fracRaw.replace(/0+$/, '');
+    return frac.length > 0 ? `${intPart}.${frac}` : intPart;
+}
+export async function readChainlinkLatest(feed, publicClient) {
+    const [latest, decimals] = await Promise.all([
+        publicClient.readContract({
+            address: feed,
+            abi: AGGREGATOR_V3_ABI,
+            functionName: 'latestRoundData',
+        }),
+        publicClient.readContract({
+            address: feed,
+            abi: AGGREGATOR_V3_ABI,
+            functionName: 'decimals',
+        }),
+    ]);
+    const [roundId, answer, startedAt, updatedAt, answeredInRound] = latest;
+    return {
+        roundId,
+        answer,
+        // Chainlink timestamps are SECONDS → convert to ms for consistency with rest of codebase
+        startedAt: Number(startedAt) * 1000,
+        updatedAt: Number(updatedAt) * 1000,
+        answeredInRound,
+        decimals: decimals,
+    };
+}
+export async function readChainlinkRound(feed, roundId, publicClient, decimals) {
+    const round = await publicClient.readContract({
+        address: feed,
+        abi: AGGREGATOR_V3_ABI,
+        functionName: 'getRoundData',
+        args: [roundId],
+    });
+    const [rid, answer, startedAt, updatedAt, answeredInRound] = round;
+    return {
+        roundId: rid,
+        answer,
+        startedAt: Number(startedAt) * 1000,
+        updatedAt: Number(updatedAt) * 1000,
+        answeredInRound,
+        decimals,
+    };
+}
+/**
+ * Find the Chainlink round that "spans" resolveTs: round R where
+ * R.updatedAt ≤ resolveTs < (R+1).updatedAt.
+ *
+ * If the latest round's updatedAt ≤ resolveTs (i.e. no newer round yet),
+ * returns { round: latest, nextRound: null, spanning: false }. Caller should
+ * retry later (availability check will mark SKIP → INDETERMINATE verdict).
+ */
+export async function oraclePriceAtResolveTs(feed, resolveTs, publicClient) {
+    const latest = await readChainlinkLatest(feed, publicClient);
+    // Case A: latest is at-or-before resolveTs → no newer round yet
+    if (latest.updatedAt <= resolveTs) {
+        return { round: latest, nextRound: null, spanning: false };
+    }
+    // Case B: latest is after resolveTs → walk back to find spanning round
+    let nextRound = latest;
+    let cursor = latest.roundId - 1n;
+    while (cursor > 0n) {
+        const r = await readChainlinkRound(feed, cursor, publicClient, latest.decimals);
+        if (r.updatedAt <= resolveTs) {
+            return { round: r, nextRound, spanning: true };
+        }
+        nextRound = r;
+        cursor -= 1n;
+    }
+    // Walked back to round 0 without finding a pre-resolveTs round — oracle is
+    // newer than the window. Surface as not-spanning so caller INDETERMINATE-s.
+    return { round: latest, nextRound: null, spanning: false };
+}
+//# sourceMappingURL=client.js.map

package/dist/venues/chainlink/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/venues/chainlink/client.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC5C;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC5C;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KACvC;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;KACxC;CACO,CAAC;AAWX,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2DAA2D,MAAM,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC5B,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7C,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAmB,EACnB,YAA0B;IAE1B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3C,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,iBAAiB;YACtB,YAAY,EAAE,iBAAiB;SAChC,CAAC;QACF,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,iBAAiB;YACtB,YAAY,EAAE,UAAU;SACzB,CAAC;KACH,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,GAAG,MAAkD,CAAC;IACpH,OAAO;QACL,OAAO;QACP,MAAM;QACN,yFAAyF;QACzF,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;QACnC,eAAe;QACf,QAAQ,EAAE,QAAkB;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAmB,EACnB,OAAe,EACf,YAA0B,EAC1B,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;QAC5C,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,iBAAiB;QACtB,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,GAAG,KAAiD,CAAC;IAC/G,OAAO;QACL,OAAO,EAAE,GAAG;QACZ,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;QACnC,eAAe;QACf,QAAQ;KACT,CAAC;AACJ,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAmB,EACnB,SAAiB,EACjB,YAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7D,gEAAgE;IAChE,IAAI,MAAM,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;IACD,uEAAuE;IACvE,IAAI,SAAS,GAAG,MAAM,CAAC;IACvB,IAAI,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;IACjC,OAAO,MAAM,GAAG,EAAE,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChF,IAAI,CAAC,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QACD,SAAS,GAAG,CAAC,CAAC;QACd,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IACD,2EAA2E;IAC3E,4EAA4E;IAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC"}

package/dist/venues/chainlink/feeds.d.ts

@@ -0,0 +1,8 @@
+/** Known Chainlink AggregatorV3 feeds on Base + Base Sepolia. */
+export declare const BASE_SEPOLIA_FEEDS: {
+    readonly 'ETH / USD': "0x4aDC67696bA383F43DD60A9e78F2C97Fbbfc7cb1";
+    readonly 'BTC / USD': "0x0FB99723Aee6f420beAD13e6bBB79b7E6F034298";
+};
+export declare const BASE_FEEDS: {
+    readonly 'ETH / USD': "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70";
+};

package/dist/venues/chainlink/feeds.js

@@ -0,0 +1,9 @@
+/** Known Chainlink AggregatorV3 feeds on Base + Base Sepolia. */
+export const BASE_SEPOLIA_FEEDS = {
+    'ETH / USD': '0x4aDC67696bA383F43DD60A9e78F2C97Fbbfc7cb1',
+    'BTC / USD': '0x0FB99723Aee6f420beAD13e6bBB79b7E6F034298',
+};
+export const BASE_FEEDS = {
+    'ETH / USD': '0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70',
+};
+//# sourceMappingURL=feeds.js.map

package/dist/venues/chainlink/feeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.js","sourceRoot":"","sources":["../../../src/venues/chainlink/feeds.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE,4CAAqD;IAClE,WAAW,EAAE,4CAAqD;CAC1D,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,4CAAqD;CAC1D,CAAC"}

package/dist/venues/hyperliquid/account-value.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Unified account-value helper.
+ *
+ * Returns a single equity figure that sums perps margin + spot USDC. This
+ * matches HL's `portfolio` endpoint `accountValueHistory` (which also
+ * reports the unified view), so restorer-claimed equity and evaluator-
+ * rederived grid points compare cleanly.
+ *
+ * Non-USDC spot tokens are NOT valued in v0 — their midprice lookup and
+ * safety semantics are out of scope for the first cut of portfolio.v0.
+ */
+import type { HlClearinghouseState, HlSpotClearinghouseState } from './types.js';
+export interface UnifiedAccountValue {
+    /** Sum of perps accountValue + spot USDC balance, as a decimal string. */
+    accountValue: string;
+    /** Perps-only accountValue (marginSummary.accountValue). */
+    perpsAccountValue: string;
+    /** Spot USDC balance (0 if absent). */
+    spotUsdc: string;
+    /** Raw perps payload from HL. */
+    clearinghouseState: HlClearinghouseState;
+    /** Raw spot payload from HL. */
+    spotClearinghouseState: HlSpotClearinghouseState;
+}
+interface HlClientLike {
+    clearinghouseState: (user: string) => Promise<HlClearinghouseState>;
+    spotClearinghouseState: (user: string) => Promise<HlSpotClearinghouseState>;
+}
+export declare function getUnifiedAccountValue(hlClient: HlClientLike, user: string): Promise<UnifiedAccountValue>;
+export {};