Class HyperliquidNormalizer

core/src/exchanges/hyperliquid/normalizer.ts:198–545

// ----------------------------------------------------------------------------

export class HyperliquidNormalizer implements IExchangeNormalizer<HyperliquidRawOutcomeWithQuestion, HyperliquidRawQuestion> {

    normalizeMarket(raw: HyperliquidRawOutcomeWithQuestion): UnifiedMarket | null {
        if (!raw || !raw.outcome) return null;

        const outcome = raw.outcome;
        const outcomeId = outcome.outcome;
        const parsed = parseDescription(outcome.description);

        // Also parse the question description for context (e.g. priceThresholds)
        const questionParsed = raw.question
            ? parseDescription(raw.question.description)
            : undefined;

        const midPrice = raw.midPrice ? parseFloat(raw.midPrice) : 0.5;
        const yesPrice = Math.max(0, Math.min(1, midPrice));
        const noPrice = Math.max(0, Math.min(1, 1 - midPrice));

        const outcomes: MarketOutcome[] = [];
        for (const side of outcome.sideSpecs) {
            const sideKey = side.name.toLowerCase() === 'yes' ? 'yes' as const : 'no' as const;
            outcomes.push({
                outcomeId: toOutcomeId(outcomeId, sideKey),
                marketId: toMarketId(outcomeId),
                label: side.name,
                price: sideKey === 'yes' ? yesPrice : noPrice,
            });
        }

        // If no sideSpecs provided, default to Yes/No
        if (outcomes.length === 0) {
            outcomes.push(
                {
                    outcomeId: toOutcomeId(outcomeId, 'yes'),
                    marketId: toMarketId(outcomeId),
                    label: 'Yes',
                    price: yesPrice,
                },
                {
                    outcomeId: toOutcomeId(outcomeId, 'no'),
                    marketId: toMarketId(outcomeId),
                    label: 'No',
                    price: noPrice,
                },
            );
        }

        // Resolution date: prefer outcome-level expiry, then question-level expiry tag,
        // then a deadline phrase scraped from the question's prose description.
        const expiryDate = parsed.expiryDate
            ?? questionParsed?.expiryDate
            ?? parseDeadlineFromText(raw.question?.description ?? "");

        // Build a descriptive title from the parsed description
        const title = buildTitle(outcome.name, parsed, questionParsed);

        // Derive underlying from outcome or question
        const underlying = parsed.underlying ?? questionParsed?.underlying;