clodds 1.1.0

package/dist/utils/kalshi-auth.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Kalshi API authentication helpers (RSA-PSS signing).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeKalshiPrivateKey = normalizeKalshiPrivateKey;
+exports.buildKalshiSignature = buildKalshiSignature;
+exports.buildKalshiHeadersForUrl = buildKalshiHeadersForUrl;
+const crypto_1 = require("crypto");
+function normalizeKalshiPrivateKey(input) {
+    const trimmed = input.trim();
+    if (trimmed.startsWith('-----BEGIN')) {
+        return trimmed;
+    }
+    try {
+        const decoded = Buffer.from(trimmed, 'base64').toString('utf8').trim();
+        if (decoded.startsWith('-----BEGIN')) {
+            return decoded;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return trimmed;
+}
+function buildKalshiSignature(auth, method, pathWithoutQuery, timestampMs) {
+    const message = `${timestampMs}${method.toUpperCase()}${pathWithoutQuery}`;
+    const signer = (0, crypto_1.createSign)('RSA-SHA256');
+    signer.update(message);
+    signer.end();
+    const signature = signer.sign({
+        key: normalizeKalshiPrivateKey(auth.privateKeyPem),
+        padding: crypto_1.constants.RSA_PKCS1_PSS_PADDING,
+        saltLength: crypto_1.constants.RSA_PSS_SALTLEN_DIGEST,
+    });
+    return signature.toString('base64');
+}
+function buildKalshiHeadersForUrl(auth, method, url, timestampMs = Date.now()) {
+    const parsed = new URL(url);
+    const path = parsed.pathname;
+    const signature = buildKalshiSignature(auth, method, path, timestampMs);
+    return {
+        'KALSHI-ACCESS-KEY': auth.apiKeyId,
+        'KALSHI-ACCESS-TIMESTAMP': timestampMs.toString(),
+        'KALSHI-ACCESS-SIGNATURE': signature,
+    };
+}
+//# sourceMappingURL=kalshi-auth.js.map

package/dist/utils/kalshi-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kalshi-auth.js","sourceRoot":"","sources":["../../src/utils/kalshi-auth.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,8DAgBC;AAED,oDAkBC;AAED,4DAeC;AA5DD,mCAAkE;AAOlE,SAAgB,yBAAyB,CAAC,KAAa;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACvE,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,oBAAoB,CAClC,IAAsB,EACtB,MAAc,EACd,gBAAwB,EACxB,WAAmB;IAEnB,MAAM,OAAO,GAAG,GAAG,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC3E,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,YAAY,CAAC,CAAC;IACxC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,CAAC;IAEb,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;QAC5B,GAAG,EAAE,yBAAyB,CAAC,IAAI,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,kBAAe,CAAC,qBAAqB;QAC9C,UAAU,EAAE,kBAAe,CAAC,sBAAsB;KACnD,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,wBAAwB,CACtC,IAAsB,EACtB,MAAc,EACd,GAAW,EACX,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAExE,OAAO;QACL,mBAAmB,EAAE,IAAI,CAAC,QAAQ;QAClC,yBAAyB,EAAE,WAAW,CAAC,QAAQ,EAAE;QACjD,yBAAyB,EAAE,SAAS;KACrC,CAAC;AACJ,CAAC"}

package/dist/utils/kelly.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Kelly Criterion Position Sizing
+ *
+ * Implements Kelly criterion for optimal bet sizing with various adjustments:
+ * - Full Kelly, Half Kelly, Quarter Kelly
+ * - Multi-outcome Kelly
+ * - Fractional Kelly with custom multiplier
+ * - Kelly with edge and probability uncertainty
+ * - Portfolio-level Kelly allocation
+ */
+export interface KellyInput {
+    /** Probability of winning (0-1) */
+    winProb: number;
+    /** Payout odds (e.g., 2.0 = 2:1 odds, you win 2x your stake) */
+    odds: number;
+    /** Current bankroll/balance */
+    bankroll: number;
+    /** Confidence in probability estimate (0-1, default: 1) */
+    confidence?: number;
+}
+export interface KellyResult {
+    /** Full Kelly bet size */
+    fullKelly: number;
+    /** Half Kelly bet size (recommended for most traders) */
+    halfKelly: number;
+    /** Quarter Kelly bet size (conservative) */
+    quarterKelly: number;
+    /** Kelly fraction (0-1) */
+    kellyFraction: number;
+    /** Expected value of the bet */
+    expectedValue: number;
+    /** Whether the bet has positive expected value */
+    hasPositiveEV: boolean;
+    /** Recommended fraction (adjusted for confidence) */
+    recommendedFraction: number;
+    /** Recommended bet size */
+    recommendedSize: number;
+}
+export interface MultiOutcomeKellyInput {
+    /** Array of outcomes with probabilities and payouts */
+    outcomes: Array<{
+        name: string;
+        probability: number;
+        payout: number;
+    }>;
+    /** Current bankroll */
+    bankroll: number;
+    /** Confidence in probability estimates */
+    confidence?: number;
+}
+export interface MultiOutcomeKellyResult {
+    /** Allocation to each outcome (as fraction of bankroll) */
+    allocations: Array<{
+        name: string;
+        fraction: number;
+        amount: number;
+        expectedValue: number;
+    }>;
+    /** Total allocation (should be <= 1) */
+    totalAllocation: number;
+    /** Expected portfolio return */
+    expectedReturn: number;
+    /** Whether any bets are recommended */
+    hasRecommendedBets: boolean;
+}
+export interface PortfolioKellyInput {
+    /** Multiple betting opportunities */
+    opportunities: Array<{
+        id: string;
+        winProb: number;
+        odds: number;
+        /** Correlation with other bets (-1 to 1) */
+        correlations?: Record<string, number>;
+    }>;
+    /** Total bankroll */
+    bankroll: number;
+    /** Maximum allocation per bet (0-1, default: 0.25) */
+    maxPerBet?: number;
+    /** Confidence in estimates */
+    confidence?: number;
+}
+export interface PortfolioKellyResult {
+    /** Allocation to each opportunity */
+    allocations: Record<string, {
+        fraction: number;
+        amount: number;
+    }>;
+    /** Total allocation */
+    totalAllocation: number;
+    /** Expected portfolio return */
+    expectedPortfolioReturn: number;
+}
+/**
+ * Calculate Kelly criterion for a single binary bet
+ *
+ * Kelly fraction = (bp - q) / b
+ * Where:
+ * - b = odds (net odds, e.g., for +200, b = 2)
+ * - p = probability of winning
+ * - q = probability of losing (1 - p)
+ */
+export declare function calculateKelly(input: KellyInput): KellyResult;
+/**
+ * Calculate Kelly for prediction market trades
+ *
+ * In prediction markets:
+ * - Price represents implied probability
+ * - If you estimate true probability > price, buy YES
+ * - If you estimate true probability < price, buy NO
+ */
+export declare function calculatePredictionMarketKelly(marketPrice: number, estimatedProbability: number, bankroll: number, confidence?: number): KellyResult;
+/**
+ * Calculate Kelly for multiple mutually exclusive outcomes
+ * (e.g., a multi-choice prediction market)
+ *
+ * Uses the generalized Kelly criterion for multiple outcomes
+ */
+export declare function calculateMultiOutcomeKelly(input: MultiOutcomeKellyInput): MultiOutcomeKellyResult;
+/**
+ * Calculate Kelly allocations for a portfolio of bets
+ * Accounts for correlations between bets
+ */
+export declare function calculatePortfolioKelly(input: PortfolioKellyInput): PortfolioKellyResult;
+/**
+ * Convert American odds to decimal odds
+ */
+export declare function americanToDecimal(american: number): number;
+/**
+ * Convert decimal odds to probability
+ */
+export declare function oddsToProb(odds: number): number;
+/**
+ * Convert probability to decimal odds
+ */
+export declare function probToOdds(prob: number): number;
+/**
+ * Calculate edge from market price and estimated probability
+ */
+export declare function calculateEdge(marketPrice: number, estimatedProbability: number): number;
+/**
+ * Calculate optimal fraction for a given edge and variance
+ */
+export declare function edgeToKelly(edge: number, odds: number): number;
+/**
+ * Suggest Kelly fraction based on confidence level
+ */
+export declare function suggestKellyFraction(confidenceLevel: 'very_high' | 'high' | 'medium' | 'low' | 'very_low'): number;
+/**
+ * Calculate position size with all safety limits applied
+ */
+export declare function calculateSafePositionSize(kellyResult: KellyResult, maxPositionPct?: number, // Max 10% of bankroll
+minPositionSize?: number, // Min $1
+maxPositionSize?: number): number;

package/dist/utils/kelly.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * Kelly Criterion Position Sizing
+ *
+ * Implements Kelly criterion for optimal bet sizing with various adjustments:
+ * - Full Kelly, Half Kelly, Quarter Kelly
+ * - Multi-outcome Kelly
+ * - Fractional Kelly with custom multiplier
+ * - Kelly with edge and probability uncertainty
+ * - Portfolio-level Kelly allocation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateKelly = calculateKelly;
+exports.calculatePredictionMarketKelly = calculatePredictionMarketKelly;
+exports.calculateMultiOutcomeKelly = calculateMultiOutcomeKelly;
+exports.calculatePortfolioKelly = calculatePortfolioKelly;
+exports.americanToDecimal = americanToDecimal;
+exports.oddsToProb = oddsToProb;
+exports.probToOdds = probToOdds;
+exports.calculateEdge = calculateEdge;
+exports.edgeToKelly = edgeToKelly;
+exports.suggestKellyFraction = suggestKellyFraction;
+exports.calculateSafePositionSize = calculateSafePositionSize;
+const logger_1 = require("./logger");
+// =============================================================================
+// BASIC KELLY CRITERION
+// =============================================================================
+/**
+ * Calculate Kelly criterion for a single binary bet
+ *
+ * Kelly fraction = (bp - q) / b
+ * Where:
+ * - b = odds (net odds, e.g., for +200, b = 2)
+ * - p = probability of winning
+ * - q = probability of losing (1 - p)
+ */
+function calculateKelly(input) {
+    const { winProb, odds, bankroll, confidence = 1 } = input;
+    // Validate inputs
+    if (winProb <= 0 || winProb >= 1) {
+        return createZeroResult(bankroll);
+    }
+    if (odds <= 0) {
+        return createZeroResult(bankroll);
+    }
+    const loseProb = 1 - winProb;
+    // Kelly formula: f* = (bp - q) / b
+    // Where b = odds - 1 (net odds)
+    const b = odds - 1; // Net odds (what you win per $1 bet)
+    const kellyFraction = (b * winProb - loseProb) / b;
+    // Expected value
+    const expectedValue = winProb * b - loseProb;
+    const hasPositiveEV = expectedValue > 0;
+    // If negative EV or negative Kelly, don't bet
+    if (kellyFraction <= 0 || !hasPositiveEV) {
+        return createZeroResult(bankroll);
+    }
+    // Adjust for confidence (reduce Kelly when uncertain)
+    const adjustedFraction = kellyFraction * confidence;
+    // Calculate bet sizes
+    const fullKelly = bankroll * Math.min(adjustedFraction, 1);
+    const halfKelly = fullKelly * 0.5;
+    const quarterKelly = fullKelly * 0.25;
+    // Recommended fraction (half Kelly is usually recommended)
+    const recommendedFraction = adjustedFraction * 0.5;
+    const recommendedSize = bankroll * Math.min(recommendedFraction, 0.25); // Cap at 25%
+    return {
+        fullKelly,
+        halfKelly,
+        quarterKelly,
+        kellyFraction: adjustedFraction,
+        expectedValue,
+        hasPositiveEV,
+        recommendedFraction,
+        recommendedSize,
+    };
+}
+function createZeroResult(bankroll) {
+    return {
+        fullKelly: 0,
+        halfKelly: 0,
+        quarterKelly: 0,
+        kellyFraction: 0,
+        expectedValue: 0,
+        hasPositiveEV: false,
+        recommendedFraction: 0,
+        recommendedSize: 0,
+    };
+}
+// =============================================================================
+// PREDICTION MARKET KELLY
+// =============================================================================
+/**
+ * Calculate Kelly for prediction market trades
+ *
+ * In prediction markets:
+ * - Price represents implied probability
+ * - If you estimate true probability > price, buy YES
+ * - If you estimate true probability < price, buy NO
+ */
+function calculatePredictionMarketKelly(marketPrice, estimatedProbability, bankroll, confidence = 1) {
+    // For buying YES shares at price p:
+    // You pay p, you win (1-p) if YES wins
+    // Odds = (1-p)/p + 1 = 1/p
+    if (estimatedProbability > marketPrice) {
+        // Buy YES
+        const odds = 1 / marketPrice;
+        return calculateKelly({
+            winProb: estimatedProbability,
+            odds,
+            bankroll,
+            confidence,
+        });
+    }
+    else if (estimatedProbability < marketPrice) {
+        // Buy NO (equivalent to betting against YES)
+        const noPrice = 1 - marketPrice;
+        const odds = 1 / noPrice;
+        const noWinProb = 1 - estimatedProbability;
+        return calculateKelly({
+            winProb: noWinProb,
+            odds,
+            bankroll,
+            confidence,
+        });
+    }
+    // No edge
+    return createZeroResult(bankroll);
+}
+// =============================================================================
+// MULTI-OUTCOME KELLY
+// =============================================================================
+/**
+ * Calculate Kelly for multiple mutually exclusive outcomes
+ * (e.g., a multi-choice prediction market)
+ *
+ * Uses the generalized Kelly criterion for multiple outcomes
+ */
+function calculateMultiOutcomeKelly(input) {
+    const { outcomes, bankroll, confidence = 1 } = input;
+    // Validate probabilities sum to ~1
+    const probSum = outcomes.reduce((sum, o) => sum + o.probability, 0);
+    if (Math.abs(probSum - 1) > 0.01) {
+        logger_1.logger.warn({ probSum }, 'Multi-outcome probabilities do not sum to 1');
+    }
+    const allocations = [];
+    // For each outcome, calculate if there's value
+    for (const outcome of outcomes) {
+        // Price implied by payout: if you bet $1 and win, you get $payout
+        // So implied price = 1/payout (approximately)
+        const impliedPrice = 1 / (1 + outcome.payout);
+        // If our probability > implied price, there's value
+        const edge = outcome.probability - impliedPrice;
+        if (edge > 0) {
+            // Calculate Kelly fraction for this outcome
+            // f = (p - impliedPrice) / (1 - impliedPrice)
+            const fraction = (edge / (1 - impliedPrice)) * confidence;
+            const amount = bankroll * Math.min(fraction, 0.25); // Cap at 25%
+            const ev = edge * amount;
+            allocations.push({
+                name: outcome.name,
+                fraction: Math.max(0, fraction),
+                amount: Math.max(0, amount),
+                expectedValue: ev,
+            });
+        }
+        else {
+            allocations.push({
+                name: outcome.name,
+                fraction: 0,
+                amount: 0,
+                expectedValue: 0,
+            });
+        }
+    }
+    const totalAllocation = allocations.reduce((sum, a) => sum + a.fraction, 0);
+    const expectedReturn = allocations.reduce((sum, a) => sum + a.expectedValue, 0);
+    const hasRecommendedBets = allocations.some((a) => a.amount > 0);
+    return {
+        allocations,
+        totalAllocation,
+        expectedReturn,
+        hasRecommendedBets,
+    };
+}
+// =============================================================================
+// PORTFOLIO KELLY
+// =============================================================================
+/**
+ * Calculate Kelly allocations for a portfolio of bets
+ * Accounts for correlations between bets
+ */
+function calculatePortfolioKelly(input) {
+    const { opportunities, bankroll, maxPerBet = 0.25, confidence = 1 } = input;
+    const allocations = {};
+    let totalAllocation = 0;
+    let expectedPortfolioReturn = 0;
+    // First pass: calculate individual Kelly fractions
+    const individualKellys = [];
+    for (const opp of opportunities) {
+        const result = calculateKelly({
+            winProb: opp.winProb,
+            odds: opp.odds,
+            bankroll,
+            confidence,
+        });
+        if (result.hasPositiveEV) {
+            individualKellys.push({
+                id: opp.id,
+                kelly: result.kellyFraction,
+                ev: result.expectedValue,
+            });
+        }
+    }
+    if (individualKellys.length === 0) {
+        return { allocations: {}, totalAllocation: 0, expectedPortfolioReturn: 0 };
+    }
+    // Normalize if total exceeds 100%
+    const totalKelly = individualKellys.reduce((sum, k) => sum + k.kelly, 0);
+    const scaleFactor = totalKelly > 1 ? 1 / totalKelly : 1;
+    // Apply correlations adjustment (simplified)
+    // Higher correlation = reduce allocation to avoid concentration
+    for (const kelly of individualKellys) {
+        const opp = opportunities.find((o) => o.id === kelly.id);
+        let adjustedFraction = kelly.kelly * scaleFactor;
+        // Reduce for correlated bets
+        if (opp.correlations) {
+            const avgCorrelation = Object.values(opp.correlations).reduce((a, b) => a + Math.abs(b), 0) /
+                Object.values(opp.correlations).length;
+            adjustedFraction *= 1 - avgCorrelation * 0.3; // Reduce by up to 30% for high correlation
+        }
+        // Apply max per bet limit
+        adjustedFraction = Math.min(adjustedFraction, maxPerBet);
+        // Apply half Kelly as default
+        adjustedFraction *= 0.5;
+        allocations[kelly.id] = {
+            fraction: adjustedFraction,
+            amount: bankroll * adjustedFraction,
+        };
+        totalAllocation += adjustedFraction;
+        expectedPortfolioReturn += kelly.ev * adjustedFraction;
+    }
+    return {
+        allocations,
+        totalAllocation,
+        expectedPortfolioReturn,
+    };
+}
+// =============================================================================
+// UTILITY FUNCTIONS
+// =============================================================================
+/**
+ * Convert American odds to decimal odds
+ */
+function americanToDecimal(american) {
+    if (american > 0) {
+        return american / 100 + 1;
+    }
+    else {
+        return 100 / Math.abs(american) + 1;
+    }
+}
+/**
+ * Convert decimal odds to probability
+ */
+function oddsToProb(odds) {
+    return 1 / odds;
+}
+/**
+ * Convert probability to decimal odds
+ */
+function probToOdds(prob) {
+    return 1 / prob;
+}
+/**
+ * Calculate edge from market price and estimated probability
+ */
+function calculateEdge(marketPrice, estimatedProbability) {
+    return estimatedProbability - marketPrice;
+}
+/**
+ * Calculate optimal fraction for a given edge and variance
+ */
+function edgeToKelly(edge, odds) {
+    if (edge <= 0)
+        return 0;
+    // Simplified: edge / (odds - 1)
+    const b = odds - 1;
+    return edge / b;
+}
+/**
+ * Suggest Kelly fraction based on confidence level
+ */
+function suggestKellyFraction(confidenceLevel) {
+    const fractions = {
+        very_high: 0.5, // Half Kelly
+        high: 0.35, // Third Kelly
+        medium: 0.25, // Quarter Kelly
+        low: 0.15, // Sixth Kelly
+        very_low: 0.1, // Tenth Kelly
+    };
+    return fractions[confidenceLevel];
+}
+/**
+ * Calculate position size with all safety limits applied
+ */
+function calculateSafePositionSize(kellyResult, maxPositionPct = 0.1, // Max 10% of bankroll
+minPositionSize = 1, // Min $1
+maxPositionSize = 10000 // Max $10k
+) {
+    // Use recommended (half Kelly) as base
+    let size = kellyResult.recommendedSize;
+    // Apply max % of bankroll
+    const bankroll = kellyResult.fullKelly / kellyResult.kellyFraction;
+    size = Math.min(size, bankroll * maxPositionPct);
+    // Apply absolute limits
+    size = Math.max(size, minPositionSize);
+    size = Math.min(size, maxPositionSize);
+    // Round to 2 decimal places
+    return Math.round(size * 100) / 100;
+}
+//# sourceMappingURL=kelly.js.map

package/dist/utils/kelly.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logger utility using Pino
+ */
+import pino from 'pino';
+declare const rootLogger: import("pino").Logger<never>;
+export declare function createLogger(name: string): pino.Logger<never>;
+export { rootLogger as logger };

package/dist/utils/logger.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Logger utility using Pino
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.createLogger = createLogger;
+const pino_1 = __importDefault(require("pino"));
+const level = process.env.LOG_LEVEL || 'info';
+const transport = pino_1.default.transport({
+    target: 'pino-pretty',
+    options: {
+        colorize: true,
+        translateTime: 'SYS:standard',
+        ignore: 'pid,hostname',
+    },
+});
+const rootLogger = (0, pino_1.default)({ level }, transport);
+exports.logger = rootLogger;
+function createLogger(name) {
+    return rootLogger.child({ name });
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAiBH,oCAEC;AAjBD,gDAAwB;AAExB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;AAE9C,MAAM,SAAS,GAAG,cAAI,CAAC,SAAS,CAAC;IAC/B,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE;QACP,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,cAAc;QAC7B,MAAM,EAAE,cAAc;KACvB;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,IAAA,cAAI,EAAC,EAAE,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;AAMvB,4BAAM;AAJ7B,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/opinion-auth.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Opinion.trade API authentication helpers.
+ * Opinion uses a simple API key header pattern.
+ */
+export interface OpinionApiAuth {
+    /** API key for Opinion.trade */
+    apiKey: string;
+}
+/**
+ * Build headers for Opinion.trade API requests.
+ * Opinion uses a simple 'apikey' header for authentication.
+ */
+export declare function buildOpinionHeaders(auth: OpinionApiAuth): Record<string, string>;
+/**
+ * Build WebSocket connection URL with API key.
+ */
+export declare function buildOpinionWsUrl(auth: OpinionApiAuth): string;

package/dist/utils/opinion-auth.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Opinion.trade API authentication helpers.
+ * Opinion uses a simple API key header pattern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOpinionHeaders = buildOpinionHeaders;
+exports.buildOpinionWsUrl = buildOpinionWsUrl;
+/**
+ * Build headers for Opinion.trade API requests.
+ * Opinion uses a simple 'apikey' header for authentication.
+ */
+function buildOpinionHeaders(auth) {
+    return {
+        'apikey': auth.apiKey,
+        'Content-Type': 'application/json',
+    };
+}
+/**
+ * Build WebSocket connection URL with API key.
+ */
+function buildOpinionWsUrl(auth) {
+    return `wss://ws.opinion.trade?apikey=${encodeURIComponent(auth.apiKey)}`;
+}
+//# sourceMappingURL=opinion-auth.js.map

package/dist/utils/opinion-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opinion-auth.js","sourceRoot":"","sources":["../../src/utils/opinion-auth.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAWH,kDAKC;AAKD,8CAEC;AAhBD;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAoB;IACtD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,cAAc,EAAE,kBAAkB;KACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,IAAoB;IACpD,OAAO,iCAAiC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/utils/polymarket-auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Polymarket CLOB authentication helpers (L2 API key auth).
+ */
+export interface PolymarketApiKeyAuth {
+    address: string;
+    apiKey: string;
+    apiSecret: string;
+    apiPassphrase: string;
+}
+export declare function buildPolymarketHmacSignature(secret: string, timestamp: string, method: string, pathWithQuery: string, body?: string): string;
+export declare function buildPolymarketHeadersForUrl(auth: PolymarketApiKeyAuth, method: string, url: string, body?: unknown, timestampSeconds?: number): Record<string, string>;

package/dist/utils/polymarket-auth.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Polymarket CLOB authentication helpers (L2 API key auth).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPolymarketHmacSignature = buildPolymarketHmacSignature;
+exports.buildPolymarketHeadersForUrl = buildPolymarketHeadersForUrl;
+const crypto_1 = require("crypto");
+function buildPolymarketHmacSignature(secret, timestamp, method, pathWithQuery, body) {
+    const key = Buffer.from(secret, 'base64');
+    const payload = `${timestamp}${method.toUpperCase()}${pathWithQuery}${body ?? ''}`;
+    return (0, crypto_1.createHmac)('sha256', key).update(payload).digest('base64');
+}
+function buildPolymarketHeadersForUrl(auth, method, url, body, timestampSeconds) {
+    const parsed = new URL(url);
+    const path = `${parsed.pathname}${parsed.search}`;
+    const timestamp = (timestampSeconds ?? Math.floor(Date.now() / 1000)).toString();
+    const bodyString = typeof body === 'string'
+        ? body
+        : body
+            ? JSON.stringify(body)
+            : '';
+    const signature = buildPolymarketHmacSignature(auth.apiSecret, timestamp, method, path, bodyString);
+    return {
+        'POLY-ADDRESS': auth.address,
+        'POLY-API-KEY': auth.apiKey,
+        'POLY-PASSPHRASE': auth.apiPassphrase,
+        'POLY-TIMESTAMP': timestamp,
+        'POLY-SIGNATURE': signature,
+    };
+}
+//# sourceMappingURL=polymarket-auth.js.map