clodds 1.1.0

package/dist/feeds/acled/index.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * ACLED (Armed Conflict Location & Event Data) Feed
+ *
+ * Real-time conflict, protest, and political violence event tracking worldwide.
+ * Requires API key (free for researchers/journalists).
+ *
+ * API docs: https://apidocs.acleddata.com
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createACLEDFeed = createACLEDFeed;
+const events_1 = require("events");
+const logger_1 = require("../../utils/logger");
+// =============================================================================
+// API HELPERS
+// =============================================================================
+const BASE_URL = 'https://api.acleddata.com/acled/read';
+function getCredentials() {
+    const apiKey = process.env.ACLED_API_KEY;
+    const email = process.env.ACLED_EMAIL || '';
+    if (!apiKey) {
+        throw new Error('ACLED_API_KEY environment variable is required');
+    }
+    return { apiKey, email };
+}
+async function acledFetch(params) {
+    const { apiKey, email } = getCredentials();
+    const queryParams = new URLSearchParams({
+        key: apiKey,
+        ...(email ? { email } : {}),
+        ...params,
+    });
+    const url = `${BASE_URL}?${queryParams.toString()}`;
+    const res = await fetch(url, {
+        headers: { 'Accept': 'application/json' },
+    });
+    if (!res.ok) {
+        throw new Error(`ACLED API error ${res.status}: ${await res.text()}`);
+    }
+    const data = await res.json();
+    if (!data.success) {
+        throw new Error(`ACLED API returned unsuccessful response`);
+    }
+    return data;
+}
+function parseEvent(raw) {
+    return {
+        eventId: raw.data_id,
+        eventDate: new Date(raw.event_date),
+        year: parseInt(raw.year, 10),
+        eventType: raw.event_type,
+        subEventType: raw.sub_event_type,
+        actor1: raw.actor1,
+        actor2: raw.actor2,
+        interaction: parseInt(raw.interaction, 10),
+        region: raw.region,
+        country: raw.country,
+        admin1: raw.admin1,
+        admin2: raw.admin2,
+        admin3: raw.admin3,
+        location: raw.location,
+        latitude: parseFloat(raw.latitude),
+        longitude: parseFloat(raw.longitude),
+        source: raw.source,
+        sourceScale: raw.source_scale,
+        notes: raw.notes,
+        fatalities: parseInt(raw.fatalities, 10) || 0,
+        timestamp: new Date(raw.timestamp ? parseInt(raw.timestamp, 10) * 1000 : raw.event_date),
+        tags: raw.tags ? raw.tags.split('; ').filter(Boolean) : undefined,
+    };
+}
+function buildQueryParams(query) {
+    const params = {};
+    if (query.country)
+        params.country = query.country;
+    if (query.region)
+        params.region = query.region;
+    if (query.eventType)
+        params.event_type = query.eventType;
+    if (query.startDate)
+        params.event_date = `${query.startDate}|${query.endDate || new Date().toISOString().slice(0, 10)}`;
+    if (query.endDate && !query.startDate)
+        params.event_date = `|${query.endDate}`;
+    if (query.minFatalities !== undefined)
+        params.fatalities = `${query.minFatalities}|`;
+    if (query.keyword)
+        params.notes = query.keyword;
+    params.limit = String(Math.min(query.limit || 500, 5000));
+    return params;
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+async function createACLEDFeed() {
+    const emitter = new events_1.EventEmitter();
+    let running = false;
+    emitter.start = async () => {
+        running = true;
+        logger_1.logger.info('ACLED conflict feed started');
+    };
+    emitter.stop = () => {
+        running = false;
+        logger_1.logger.info('ACLED conflict feed stopped');
+    };
+    emitter.getEvents = async (query) => {
+        const params = buildQueryParams(query);
+        const response = await acledFetch(params);
+        return response.data.map(parseEvent);
+    };
+    emitter.getSummary = async (country, startDate, endDate) => {
+        const events = await emitter.getEvents({
+            country,
+            startDate,
+            endDate,
+            limit: 5000,
+        });
+        const byType = {};
+        let totalFatalities = 0;
+        for (const evt of events) {
+            totalFatalities += evt.fatalities;
+            const existing = byType[evt.eventType];
+            if (existing) {
+                existing.count++;
+                existing.fatalities += evt.fatalities;
+            }
+            else {
+                byType[evt.eventType] = { count: 1, fatalities: evt.fatalities };
+            }
+        }
+        return {
+            country,
+            totalEvents: events.length,
+            totalFatalities,
+            byType,
+            period: { start: startDate, end: endDate },
+        };
+    };
+    emitter.getLatest = async (limit = 100) => {
+        const now = new Date();
+        const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        return emitter.getEvents({
+            startDate: weekAgo.toISOString().slice(0, 10),
+            endDate: now.toISOString().slice(0, 10),
+            limit,
+        });
+    };
+    emitter.getNearby = async (lat, lon, radiusKm, limit = 50) => {
+        // ACLED doesn't have a native radius query, so we compute a bounding box
+        // and post-filter by haversine distance
+        const latDelta = radiusKm / 111.32;
+        const lonDelta = radiusKm / (111.32 * Math.cos(lat * Math.PI / 180));
+        const params = {
+            latitude: `${(lat - latDelta).toFixed(4)}|${(lat + latDelta).toFixed(4)}`,
+            longitude: `${(lon - lonDelta).toFixed(4)}|${(lon + lonDelta).toFixed(4)}`,
+            limit: String(Math.min(limit * 3, 5000)), // fetch extra, filter later
+        };
+        const response = await acledFetch(params);
+        const events = response.data.map(parseEvent);
+        // Haversine post-filter
+        const filtered = events.filter(evt => {
+            const R = 6371;
+            const dLat = (evt.latitude - lat) * Math.PI / 180;
+            const dLon = (evt.longitude - lon) * Math.PI / 180;
+            const a = Math.sin(dLat / 2) ** 2 +
+                Math.cos(lat * Math.PI / 180) * Math.cos(evt.latitude * Math.PI / 180) *
+                    Math.sin(dLon / 2) ** 2;
+            const dist = R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+            return dist <= radiusKm;
+        });
+        return filtered.slice(0, limit);
+    };
+    emitter.getCountries = async () => {
+        // ACLED has no dedicated countries endpoint. Return the most commonly
+        // queried conflict-affected countries. API accepts both names and ISO codes.
+        return [
+            'Afghanistan', 'Algeria', 'Angola', 'Bangladesh', 'Brazil', 'Burkina Faso',
+            'Cameroon', 'Central African Republic', 'Chad', 'Colombia', 'DR Congo',
+            'Egypt', 'Ethiopia', 'Guatemala', 'Haiti', 'India', 'Indonesia', 'Iran',
+            'Iraq', 'Israel', 'Kenya', 'Lebanon', 'Libya', 'Mali', 'Mexico',
+            'Mozambique', 'Myanmar', 'Nicaragua', 'Niger', 'Nigeria', 'Pakistan',
+            'Palestine', 'Peru', 'Philippines', 'Russia', 'Saudi Arabia', 'Somalia',
+            'South Africa', 'South Sudan', 'Sudan', 'Syria', 'Thailand', 'Turkey',
+            'Uganda', 'Ukraine', 'Venezuela', 'Yemen', 'Zimbabwe',
+        ].sort();
+    };
+    emitter.getTrends = async (country, months = 12) => {
+        const now = new Date();
+        const startDate = new Date(now.getFullYear(), now.getMonth() - months, 1);
+        const events = await emitter.getEvents({
+            country,
+            startDate: startDate.toISOString().slice(0, 10),
+            endDate: now.toISOString().slice(0, 10),
+            limit: 5000,
+        });
+        // Group by month
+        const monthlyMap = new Map();
+        for (const evt of events) {
+            const monthKey = `${evt.eventDate.getFullYear()}-${String(evt.eventDate.getMonth() + 1).padStart(2, '0')}`;
+            const existing = monthlyMap.get(monthKey);
+            if (existing) {
+                existing.events++;
+                existing.fatalities += evt.fatalities;
+            }
+            else {
+                monthlyMap.set(monthKey, { events: 1, fatalities: evt.fatalities });
+            }
+        }
+        // Sort chronologically
+        return [...monthlyMap.entries()]
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([month, data]) => ({ month, ...data }));
+    };
+    return emitter;
+}
+//# sourceMappingURL=index.js.map

package/dist/feeds/acled/index.js.map

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

package/dist/feeds/agentbets/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AgentBets Feed
+ * Prediction markets for AI agents on Solana devnet
+ *
+ * Built for the Colosseum Agent Hackathon
+ * https://github.com/nox-oss/agentbets
+ */
+import { EventEmitter } from 'events';
+import { Market } from '../../types';
+export interface AgentBetsFeed extends EventEmitter {
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    searchMarkets: (query?: string) => Promise<Market[]>;
+    getMarket: (id: string) => Promise<Market | null>;
+    getOpportunities: () => Promise<any[]>;
+}
+export declare function createAgentBetsFeed(): Promise<AgentBetsFeed>;

package/dist/feeds/agentbets/index.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * AgentBets Feed
+ * Prediction markets for AI agents on Solana devnet
+ *
+ * Built for the Colosseum Agent Hackathon
+ * https://github.com/nox-oss/agentbets
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentBetsFeed = createAgentBetsFeed;
+const events_1 = require("events");
+const logger_1 = require("../../utils/logger");
+const API_URL = 'https://agentbets-api-production.up.railway.app';
+async function createAgentBetsFeed() {
+    const emitter = new events_1.EventEmitter();
+    let pollInterval = null;
+    const POLL_INTERVAL_MS = 30000; // 30 seconds
+    function convertToMarket(m) {
+        const totalShares = m.outcomes.reduce((sum, o) => sum + o.shares, 0) || 1;
+        const outcomes = m.outcomes.map((o, idx) => ({
+            id: `${m.id}-${idx}`,
+            name: o.name,
+            price: totalShares > 0 ? o.shares / totalShares : 0.5,
+            volume24h: 0, // Not tracked yet
+        }));
+        return {
+            id: m.id,
+            platform: 'agentbets',
+            slug: m.id,
+            question: m.question,
+            description: m.description,
+            outcomes,
+            volume24h: m.totalPool,
+            liquidity: m.totalPool,
+            endDate: new Date(m.resolutionTime),
+            resolved: m.status === 'resolved',
+            resolutionValue: m.winningOutcome ?
+                (m.outcomes.findIndex(o => o.name === m.winningOutcome) === 0 ? 1 : 0) :
+                undefined,
+            tags: ['agent-hackathon', 'solana'],
+            url: `https://github.com/nox-oss/agentbets#${m.id}`,
+            createdAt: new Date(m.createdAt),
+            updatedAt: new Date(m.updatedAt),
+        };
+    }
+    async function fetchMarkets() {
+        try {
+            const response = await fetch(`${API_URL}/markets`);
+            if (!response.ok) {
+                throw new Error(`AgentBets API error: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.markets.map(convertToMarket);
+        }
+        catch (error) {
+            logger_1.logger.error('AgentBets: Fetch error', error);
+            return [];
+        }
+    }
+    async function searchMarkets(query) {
+        const markets = await fetchMarkets();
+        if (!query)
+            return markets;
+        const lowerQuery = query.toLowerCase();
+        return markets.filter(m => m.question.toLowerCase().includes(lowerQuery) ||
+            m.description?.toLowerCase().includes(lowerQuery));
+    }
+    async function getMarket(id) {
+        try {
+            const response = await fetch(`${API_URL}/markets/${id}`);
+            if (!response.ok) {
+                if (response.status === 404)
+                    return null;
+                throw new Error(`AgentBets API error: ${response.status}`);
+            }
+            const data = await response.json();
+            return convertToMarket(data.market);
+        }
+        catch (error) {
+            logger_1.logger.error(`AgentBets: Error fetching market ${id}`, error);
+            return null;
+        }
+    }
+    async function getOpportunities() {
+        try {
+            const response = await fetch(`${API_URL}/opportunities`);
+            if (!response.ok) {
+                throw new Error(`AgentBets API error: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.opportunities || [];
+        }
+        catch (error) {
+            logger_1.logger.error('AgentBets: Opportunities fetch error', error);
+            return [];
+        }
+    }
+    function startPolling() {
+        if (pollInterval)
+            return;
+        pollInterval = setInterval(async () => {
+            try {
+                const markets = await fetchMarkets();
+                emitter.emit('markets', markets);
+            }
+            catch (error) {
+                logger_1.logger.error('AgentBets: Polling error', error);
+            }
+        }, POLL_INTERVAL_MS);
+    }
+    function stopPolling() {
+        if (pollInterval) {
+            clearInterval(pollInterval);
+            pollInterval = null;
+        }
+    }
+    return Object.assign(emitter, {
+        async connect() {
+            logger_1.logger.info('AgentBets: Connecting...');
+            // Fetch initial markets
+            const markets = await fetchMarkets();
+            logger_1.logger.info(`AgentBets: Loaded ${markets.length} markets`);
+            emitter.emit('connected');
+            emitter.emit('markets', markets);
+            // Start polling
+            startPolling();
+        },
+        disconnect() {
+            stopPolling();
+            emitter.emit('disconnected');
+        },
+        searchMarkets,
+        getMarket,
+        getOpportunities,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/feeds/agentbets/index.js.map

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

package/dist/feeds/betfair/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Betfair Exchange Feed
+ * Sports betting exchange with full trading API
+ *
+ * Features:
+ * - Market data (prices, volumes, liquidity)
+ * - Full trading (back/lay orders)
+ * - Market streaming via WebSocket
+ * - Portfolio/positions tracking
+ *
+ * Docs: https://docs.developer.betfair.com/
+ */
+import { EventEmitter } from 'events';
+import { Market, Orderbook } from '../../types';
+export interface BetfairConfig {
+    appKey: string;
+    username?: string;
+    password?: string;
+    /** Session token if already authenticated */
+    sessionToken?: string;
+    /** Cert-based auth files */
+    certPath?: string;
+    keyPath?: string;
+}
+export interface BetfairAuth {
+    appKey: string;
+    sessionToken: string;
+}
+interface BetfairPriceSize {
+    price: number;
+    size: number;
+}
+interface BetfairRunnerBook {
+    selectionId: number;
+    status: string;
+    lastPriceTraded?: number;
+    totalMatched?: number;
+    ex?: {
+        availableToBack: BetfairPriceSize[];
+        availableToLay: BetfairPriceSize[];
+        tradedVolume?: BetfairPriceSize[];
+    };
+}
+interface BetfairMarketBook {
+    marketId: string;
+    isMarketDataDelayed?: boolean;
+    status: string;
+    betDelay?: number;
+    bspReconciled?: boolean;
+    complete?: boolean;
+    inplay?: boolean;
+    numberOfWinners?: number;
+    numberOfRunners?: number;
+    numberOfActiveRunners?: number;
+    lastMatchTime?: string;
+    totalMatched?: number;
+    totalAvailable?: number;
+    runners: BetfairRunnerBook[];
+}
+interface BetfairOrder {
+    betId: string;
+    marketId: string;
+    selectionId: number;
+    side: 'BACK' | 'LAY';
+    status: string;
+    priceSize: {
+        price: number;
+        size: number;
+    };
+    bspLiability?: number;
+    placedDate: string;
+    avgPriceMatched?: number;
+    sizeMatched?: number;
+    sizeRemaining?: number;
+    sizeLapsed?: number;
+    sizeCancelled?: number;
+    sizeVoided?: number;
+}
+interface BetfairPosition {
+    marketId: string;
+    selectionId: number;
+    matchedPL?: number;
+    unmatchedPL?: number;
+}
+export interface BetfairFeed extends EventEmitter {
+    start(): Promise<void>;
+    stop(): void;
+    login(): Promise<boolean>;
+    logout(): Promise<void>;
+    isAuthenticated(): boolean;
+    searchMarkets(query: string, options?: {
+        eventTypeIds?: string[];
+        marketTypes?: string[];
+    }): Promise<Market[]>;
+    getMarket(marketId: string): Promise<Market | null>;
+    getMarketBook(marketId: string): Promise<BetfairMarketBook | null>;
+    getOrderbook(marketId: string, selectionId: number): Promise<Orderbook | null>;
+    subscribeToMarket(marketId: string): void;
+    unsubscribeFromMarket(marketId: string): void;
+    placeBackOrder(marketId: string, selectionId: number, price: number, size: number): Promise<BetfairOrder | null>;
+    placeLayOrder(marketId: string, selectionId: number, price: number, size: number): Promise<BetfairOrder | null>;
+    cancelOrder(marketId: string, betId: string): Promise<boolean>;
+    cancelAllOrders(marketId?: string): Promise<number>;
+    getOpenOrders(marketId?: string): Promise<BetfairOrder[]>;
+    getPositions(): Promise<BetfairPosition[]>;
+    getAccountFunds(): Promise<{
+        available: number;
+        exposure: number;
+        balance: number;
+    }>;
+}
+export declare function createBetfairFeed(config: BetfairConfig): Promise<BetfairFeed>;
+export declare const BETFAIR_EVENT_TYPES: {
+    SOCCER: string;
+    TENNIS: string;
+    GOLF: string;
+    CRICKET: string;
+    RUGBY_UNION: string;
+    BOXING: string;
+    HORSE_RACING: string;
+    MOTOR_SPORT: string;
+    CYCLING: string;
+    BASKETBALL: string;
+    AMERICAN_FOOTBALL: string;
+    BASEBALL: string;
+    ICE_HOCKEY: string;
+    POLITICS: string;
+    ESPORTS: string;
+    SNOOKER: string;
+    DARTS: string;
+};
+export {};