@waiaas/daemon 2.0.0-rc.1

package/dist/infrastructure/oracle/oracle-chain.js.map

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

package/dist/infrastructure/oracle/oracle-errors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared error classes for price oracle implementations.
+ *
+ * Extracted to a separate module so PythOracle and CoinGeckoOracle
+ * can share error types without circular dependencies.
+ */
+/**
+ * Thrown when a price is not available for a token from any oracle source.
+ *
+ * This is a normal flow error (not a bug) -- it means the oracle has no data
+ * for the requested token. OracleChain handles this by trying fallback sources.
+ */
+export declare class PriceNotAvailableError extends Error {
+    readonly cacheKey: string;
+    /**
+     * @param cacheKey - Cache key or descriptive message identifying the missing price.
+     */
+    constructor(cacheKey: string);
+}
+/**
+ * Thrown when forex rate is not available for a currency.
+ *
+ * ForexRateService catches this internally and returns null (graceful fallback).
+ * This class exists for internal logging/debugging purposes.
+ */
+export declare class ForexNotAvailableError extends Error {
+    readonly currency: string;
+    /**
+     * @param currency - Currency code that was requested.
+     */
+    constructor(currency: string);
+}
+/**
+ * Thrown when CoinGecko API key is not configured.
+ *
+ * CoinGecko Demo API requires an API key. This error is thrown at query time
+ * (not construction time) to allow lazy configuration via SettingsService.
+ */
+export declare class CoinGeckoNotConfiguredError extends Error {
+    constructor();
+}
+//# sourceMappingURL=oracle-errors.d.ts.map

package/dist/infrastructure/oracle/oracle-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-errors.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/oracle-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAInB,QAAQ,EAAE,MAAM;IAH5C;;OAEG;gBACyB,QAAQ,EAAE,MAAM;CAI7C;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAInB,QAAQ,EAAE,MAAM;IAH5C;;OAEG;gBACyB,QAAQ,EAAE,MAAM;CAI7C;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;;CAKrD"}

package/dist/infrastructure/oracle/oracle-errors.js

@@ -0,0 +1,53 @@
+/**
+ * Shared error classes for price oracle implementations.
+ *
+ * Extracted to a separate module so PythOracle and CoinGeckoOracle
+ * can share error types without circular dependencies.
+ */
+/**
+ * Thrown when a price is not available for a token from any oracle source.
+ *
+ * This is a normal flow error (not a bug) -- it means the oracle has no data
+ * for the requested token. OracleChain handles this by trying fallback sources.
+ */
+export class PriceNotAvailableError extends Error {
+    cacheKey;
+    /**
+     * @param cacheKey - Cache key or descriptive message identifying the missing price.
+     */
+    constructor(cacheKey) {
+        super(`Price not available for ${cacheKey}`);
+        this.cacheKey = cacheKey;
+        this.name = 'PriceNotAvailableError';
+    }
+}
+/**
+ * Thrown when forex rate is not available for a currency.
+ *
+ * ForexRateService catches this internally and returns null (graceful fallback).
+ * This class exists for internal logging/debugging purposes.
+ */
+export class ForexNotAvailableError extends Error {
+    currency;
+    /**
+     * @param currency - Currency code that was requested.
+     */
+    constructor(currency) {
+        super(`Forex rate not available for USD/${currency}`);
+        this.currency = currency;
+        this.name = 'ForexNotAvailableError';
+    }
+}
+/**
+ * Thrown when CoinGecko API key is not configured.
+ *
+ * CoinGecko Demo API requires an API key. This error is thrown at query time
+ * (not construction time) to allow lazy configuration via SettingsService.
+ */
+export class CoinGeckoNotConfiguredError extends Error {
+    constructor() {
+        super('CoinGecko API key not configured');
+        this.name = 'CoinGeckoNotConfiguredError';
+    }
+}
+//# sourceMappingURL=oracle-errors.js.map

package/dist/infrastructure/oracle/oracle-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-errors.js","sourceRoot":"","sources":["../../../src/infrastructure/oracle/oracle-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAInB;IAH5B;;OAEG;IACH,YAA4B,QAAgB;QAC1C,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;QADnB,aAAQ,GAAR,QAAQ,CAAQ;QAE1C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAInB;IAH5B;;OAEG;IACH,YAA4B,QAAgB;QAC1C,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;QAD5B,aAAQ,GAAR,QAAQ,CAAQ;QAE1C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD;QACE,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF"}

package/dist/infrastructure/oracle/price-age.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Price age classification utility.
+ *
+ * Classifies how old a price observation is into three buckets:
+ * - FRESH (< 5 minutes): Safe to use directly
+ * - AGING (5-30 minutes): Usable with warning, may trigger re-fetch
+ * - STALE (>= 30 minutes): Should not be used for policy evaluation
+ *
+ * Note: These thresholds align with InMemoryPriceCache:
+ * - FRESH_MAX_MS matches cache TTL (5 min)
+ * - AGING_MAX_MS matches cache staleMax (30 min)
+ *
+ * IMPORTANT: Do not confuse PriceInfo.isStale (cache TTL expired, >5min)
+ * with PriceAge 'STALE' (>30min). They are different concepts.
+ */
+import { z } from 'zod';
+/** Valid price age categories. */
+export declare const PRICE_AGES: readonly ["FRESH", "AGING", "STALE"];
+/** Price age discriminant type. */
+export type PriceAge = (typeof PRICE_AGES)[number];
+/** Zod enum for runtime validation of PriceAge values. */
+export declare const PriceAgeEnum: z.ZodEnum<["FRESH", "AGING", "STALE"]>;
+/** Threshold constants for price age classification (milliseconds). */
+export declare const PRICE_AGE_THRESHOLDS: {
+    /** Maximum age for FRESH classification: 5 minutes. */
+    readonly FRESH_MAX_MS: number;
+    /** Maximum age for AGING classification: 30 minutes. Beyond this = STALE. */
+    readonly AGING_MAX_MS: number;
+};
+/**
+ * Classify the age of a price observation.
+ *
+ * @param fetchedAt - Unix timestamp (ms) when price was fetched.
+ * @param now - Current time (ms). Defaults to Date.now(). Inject for testing.
+ * @returns PriceAge discriminant: 'FRESH', 'AGING', or 'STALE'.
+ */
+export declare function classifyPriceAge(fetchedAt: number, now?: number): PriceAge;
+//# sourceMappingURL=price-age.d.ts.map

package/dist/infrastructure/oracle/price-age.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-age.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/price-age.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kCAAkC;AAClC,eAAO,MAAM,UAAU,sCAAuC,CAAC;AAE/D,mCAAmC;AACnC,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,0DAA0D;AAC1D,eAAO,MAAM,YAAY,wCAAqB,CAAC;AAE/C,uEAAuE;AACvE,eAAO,MAAM,oBAAoB;IAC/B,uDAAuD;;IAEvD,6EAA6E;;CAErE,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAO1E"}

package/dist/infrastructure/oracle/price-age.js

@@ -0,0 +1,44 @@
+/**
+ * Price age classification utility.
+ *
+ * Classifies how old a price observation is into three buckets:
+ * - FRESH (< 5 minutes): Safe to use directly
+ * - AGING (5-30 minutes): Usable with warning, may trigger re-fetch
+ * - STALE (>= 30 minutes): Should not be used for policy evaluation
+ *
+ * Note: These thresholds align with InMemoryPriceCache:
+ * - FRESH_MAX_MS matches cache TTL (5 min)
+ * - AGING_MAX_MS matches cache staleMax (30 min)
+ *
+ * IMPORTANT: Do not confuse PriceInfo.isStale (cache TTL expired, >5min)
+ * with PriceAge 'STALE' (>30min). They are different concepts.
+ */
+import { z } from 'zod';
+/** Valid price age categories. */
+export const PRICE_AGES = ['FRESH', 'AGING', 'STALE'];
+/** Zod enum for runtime validation of PriceAge values. */
+export const PriceAgeEnum = z.enum(PRICE_AGES);
+/** Threshold constants for price age classification (milliseconds). */
+export const PRICE_AGE_THRESHOLDS = {
+    /** Maximum age for FRESH classification: 5 minutes. */
+    FRESH_MAX_MS: 5 * 60 * 1000, // 300,000 ms
+    /** Maximum age for AGING classification: 30 minutes. Beyond this = STALE. */
+    AGING_MAX_MS: 30 * 60 * 1000, // 1,800,000 ms
+};
+/**
+ * Classify the age of a price observation.
+ *
+ * @param fetchedAt - Unix timestamp (ms) when price was fetched.
+ * @param now - Current time (ms). Defaults to Date.now(). Inject for testing.
+ * @returns PriceAge discriminant: 'FRESH', 'AGING', or 'STALE'.
+ */
+export function classifyPriceAge(fetchedAt, now) {
+    const currentTime = now ?? Date.now();
+    const ageMs = currentTime - fetchedAt;
+    if (ageMs < PRICE_AGE_THRESHOLDS.FRESH_MAX_MS)
+        return 'FRESH';
+    if (ageMs < PRICE_AGE_THRESHOLDS.AGING_MAX_MS)
+        return 'AGING';
+    return 'STALE';
+}
+//# sourceMappingURL=price-age.js.map

package/dist/infrastructure/oracle/price-age.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-age.js","sourceRoot":"","sources":["../../../src/infrastructure/oracle/price-age.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kCAAkC;AAClC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAK/D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAE/C,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,uDAAuD;IACvD,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,aAAa;IAC5C,6EAA6E;IAC7E,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAG,eAAe;CACtC,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,GAAY;IAC9D,MAAM,WAAW,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;IAEtC,IAAI,KAAK,GAAG,oBAAoB,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC;IAC9D,IAAI,KAAK,GAAG,oBAAoB,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC;IAC9D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/infrastructure/oracle/price-cache.d.ts

@@ -0,0 +1,99 @@
+/**
+ * In-memory price cache with LRU eviction and stampede prevention.
+ *
+ * Uses ES Map insertion order for O(1) LRU eviction (delete+set to touch).
+ * No external dependencies -- v1.5 decision: 0 new npm packages.
+ *
+ * Terminology:
+ * - TTL (5 min default): Time after which get() returns null (cache miss).
+ * - staleMax (30 min default): Time after which getStale() also returns null.
+ *   Between TTL and staleMax, getStale() returns the old value for fallback use.
+ * - maxEntries (128 default): LRU capacity. Oldest entry evicted on overflow.
+ */
+import type { PriceInfo, CacheStats } from '@waiaas/core';
+/**
+ * Build a normalized cache key for a token.
+ *
+ * EVM addresses are lowercased for consistency with CoinGecko API responses
+ * and EIP-55 checksum normalization.
+ *
+ * @param chain - Chain identifier ('solana' | 'ethereum').
+ * @param address - Token address (mint for Solana, contract for EVM).
+ * @returns Normalized cache key in format `chain:address`.
+ */
+export declare function buildCacheKey(chain: string, address: string): string;
+/**
+ * In-memory price cache with LRU eviction and cache stampede prevention.
+ *
+ * - LRU: Map insertion order tracks access recency. get() does delete+set to touch.
+ * - TTL: Entries expire after ttlMs. get() returns null for expired entries.
+ * - Stale: getStale() returns expired-but-not-too-old entries for fallback.
+ * - Stampede: getOrFetch() coalesces concurrent requests for the same key.
+ */
+export declare class InMemoryPriceCache {
+    private readonly ttlMs;
+    private readonly staleMaxMs;
+    private readonly maxEntries;
+    /** Default TTL: 5 minutes. */
+    static readonly DEFAULT_TTL_MS: number;
+    /** Default stale max: 30 minutes. */
+    static readonly DEFAULT_STALE_MAX_MS: number;
+    /** Default max entries: 128. */
+    static readonly DEFAULT_MAX_ENTRIES = 128;
+    private readonly cache;
+    private readonly inflightRequests;
+    private stats;
+    constructor(ttlMs?: number, staleMaxMs?: number, maxEntries?: number);
+    /**
+     * Get a cached price entry.
+     *
+     * Returns null if the key doesn't exist or the entry has expired past TTL.
+     * On hit, performs LRU touch (delete+set to move to most recent position).
+     *
+     * @param key - Cache key (use buildCacheKey to generate).
+     * @returns PriceInfo if cached and within TTL, null otherwise.
+     */
+    get(key: string): PriceInfo | null;
+    /**
+     * Get stale cached data (past TTL but within staleMax).
+     *
+     * Used as fallback when oracle is temporarily unavailable.
+     *
+     * @param key - Cache key.
+     * @returns PriceInfo if within staleMax window, null otherwise.
+     */
+    getStale(key: string): PriceInfo | null;
+    /**
+     * Store a price in the cache.
+     *
+     * If the cache is at capacity and the key is new, the oldest entry (first
+     * Map key per insertion order) is evicted.
+     *
+     * @param key - Cache key.
+     * @param price - Price data to cache.
+     */
+    set(key: string, price: PriceInfo): void;
+    /**
+     * Get a price from cache, or fetch it if not cached.
+     *
+     * Implements cache stampede prevention: concurrent calls for the same key
+     * share a single inflight Promise. On error, the inflight is cleared so
+     * subsequent calls can retry.
+     *
+     * @param key - Cache key.
+     * @param fetcher - Async function to fetch the price on cache miss.
+     * @returns The cached or freshly fetched PriceInfo.
+     */
+    getOrFetch(key: string, fetcher: () => Promise<PriceInfo>): Promise<PriceInfo>;
+    /**
+     * Get cache statistics.
+     *
+     * @returns Current cache stats including hits, misses, staleHits, size, evictions.
+     */
+    getStats(): CacheStats;
+    /**
+     * Clear all cached entries and reset statistics.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=price-cache.d.ts.map

package/dist/infrastructure/oracle/price-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-cache.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/price-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1D;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAa3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAd7B,8BAA8B;IAC9B,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAiB;IAC/C,qCAAqC;IACrC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,SAAkB;IACtD,gCAAgC;IAChC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,OAAO;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;IAC1E,OAAO,CAAC,KAAK,CAAsD;gBAGhD,KAAK,GAAE,MAA0C,EACjD,UAAU,GAAE,MAAgD,EAC5D,UAAU,GAAE,MAA+C;IAG9E;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAoBlC;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAkBvC;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAuBxC;;;;;;;;;;OAUG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAuBpF;;;;OAIG;IACH,QAAQ,IAAI,UAAU;IAOtB;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/infrastructure/oracle/price-cache.js

@@ -0,0 +1,173 @@
+/**
+ * Build a normalized cache key for a token.
+ *
+ * EVM addresses are lowercased for consistency with CoinGecko API responses
+ * and EIP-55 checksum normalization.
+ *
+ * @param chain - Chain identifier ('solana' | 'ethereum').
+ * @param address - Token address (mint for Solana, contract for EVM).
+ * @returns Normalized cache key in format `chain:address`.
+ */
+export function buildCacheKey(chain, address) {
+    const normalizedAddress = chain === 'ethereum'
+        ? address.toLowerCase()
+        : address;
+    return `${chain}:${normalizedAddress}`;
+}
+/**
+ * In-memory price cache with LRU eviction and cache stampede prevention.
+ *
+ * - LRU: Map insertion order tracks access recency. get() does delete+set to touch.
+ * - TTL: Entries expire after ttlMs. get() returns null for expired entries.
+ * - Stale: getStale() returns expired-but-not-too-old entries for fallback.
+ * - Stampede: getOrFetch() coalesces concurrent requests for the same key.
+ */
+export class InMemoryPriceCache {
+    ttlMs;
+    staleMaxMs;
+    maxEntries;
+    /** Default TTL: 5 minutes. */
+    static DEFAULT_TTL_MS = 5 * 60 * 1000;
+    /** Default stale max: 30 minutes. */
+    static DEFAULT_STALE_MAX_MS = 30 * 60 * 1000;
+    /** Default max entries: 128. */
+    static DEFAULT_MAX_ENTRIES = 128;
+    cache = new Map();
+    inflightRequests = new Map();
+    stats = { hits: 0, misses: 0, staleHits: 0, evictions: 0 };
+    constructor(ttlMs = InMemoryPriceCache.DEFAULT_TTL_MS, staleMaxMs = InMemoryPriceCache.DEFAULT_STALE_MAX_MS, maxEntries = InMemoryPriceCache.DEFAULT_MAX_ENTRIES) {
+        this.ttlMs = ttlMs;
+        this.staleMaxMs = staleMaxMs;
+        this.maxEntries = maxEntries;
+    }
+    /**
+     * Get a cached price entry.
+     *
+     * Returns null if the key doesn't exist or the entry has expired past TTL.
+     * On hit, performs LRU touch (delete+set to move to most recent position).
+     *
+     * @param key - Cache key (use buildCacheKey to generate).
+     * @returns PriceInfo if cached and within TTL, null otherwise.
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return null;
+        }
+        const now = Date.now();
+        if (now >= entry.expiresAt) {
+            this.stats.misses++;
+            return null;
+        }
+        // LRU touch: delete and re-insert to move to end (most recent)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        this.stats.hits++;
+        return entry.price;
+    }
+    /**
+     * Get stale cached data (past TTL but within staleMax).
+     *
+     * Used as fallback when oracle is temporarily unavailable.
+     *
+     * @param key - Cache key.
+     * @returns PriceInfo if within staleMax window, null otherwise.
+     */
+    getStale(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        const now = Date.now();
+        if (now >= entry.staleExpiresAt) {
+            return null;
+        }
+        // Only count as staleHit if actually past TTL
+        if (now >= entry.expiresAt) {
+            this.stats.staleHits++;
+        }
+        return entry.price;
+    }
+    /**
+     * Store a price in the cache.
+     *
+     * If the cache is at capacity and the key is new, the oldest entry (first
+     * Map key per insertion order) is evicted.
+     *
+     * @param key - Cache key.
+     * @param price - Price data to cache.
+     */
+    set(key, price) {
+        // Evict oldest if at capacity and this is a new key
+        if (this.cache.size >= this.maxEntries && !this.cache.has(key)) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+                this.stats.evictions++;
+            }
+        }
+        const now = Date.now();
+        const entry = {
+            price,
+            cachedAt: now,
+            expiresAt: now + this.ttlMs,
+            staleExpiresAt: now + this.staleMaxMs,
+        };
+        // Delete first to ensure insertion at end (most recent position)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+    }
+    /**
+     * Get a price from cache, or fetch it if not cached.
+     *
+     * Implements cache stampede prevention: concurrent calls for the same key
+     * share a single inflight Promise. On error, the inflight is cleared so
+     * subsequent calls can retry.
+     *
+     * @param key - Cache key.
+     * @param fetcher - Async function to fetch the price on cache miss.
+     * @returns The cached or freshly fetched PriceInfo.
+     */
+    async getOrFetch(key, fetcher) {
+        // 1. Cache hit
+        const cached = this.get(key);
+        if (cached)
+            return cached;
+        // 2. Join existing inflight request (stampede prevention)
+        const inflight = this.inflightRequests.get(key);
+        if (inflight)
+            return inflight;
+        // 3. Start new fetch
+        const promise = fetcher()
+            .then((price) => {
+            this.set(key, price);
+            return price;
+        })
+            .finally(() => {
+            this.inflightRequests.delete(key);
+        });
+        this.inflightRequests.set(key, promise);
+        return promise;
+    }
+    /**
+     * Get cache statistics.
+     *
+     * @returns Current cache stats including hits, misses, staleHits, size, evictions.
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            size: this.cache.size,
+        };
+    }
+    /**
+     * Clear all cached entries and reset statistics.
+     */
+    clear() {
+        this.cache.clear();
+        this.inflightRequests.clear();
+        this.stats = { hits: 0, misses: 0, staleHits: 0, evictions: 0 };
+    }
+}
+//# sourceMappingURL=price-cache.js.map

package/dist/infrastructure/oracle/price-cache.js.map

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

package/dist/infrastructure/oracle/pyth-feed-ids.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pyth Hermes feed ID hardcoded mappings.
+ *
+ * Maps cache keys (`chain:address`) to Pyth price feed IDs (hex, no 0x prefix).
+ * These feed IDs are chain-agnostic -- Pyth uses the same feed for SOL/USD
+ * regardless of whether the query comes from Solana or EVM context.
+ *
+ * Only major tokens are hardcoded. Tokens without a feed ID will trigger
+ * PriceNotAvailableError in PythOracle, causing OracleChain to fall back
+ * to CoinGecko.
+ *
+ * Feed IDs verified via Pyth Hermes /v2/price_feeds API (2026-02-15).
+ */
+import type { ChainType } from '@waiaas/core';
+/** Hardcoded Pyth price feed IDs for major tokens. */
+export declare const PYTH_FEED_IDS: ReadonlyMap<string, string>;
+/**
+ * Look up a Pyth feed ID by cache key.
+ *
+ * @param cacheKey - Normalized cache key (e.g. `solana:native`, `ethereum:0xaddr`).
+ * @returns Feed ID hex string (no 0x prefix) or undefined if not registered.
+ */
+export declare function getFeedId(cacheKey: string): string | undefined;
+/**
+ * Get the Pyth feed ID for a chain's native token.
+ *
+ * @param chain - Chain type ('solana' or 'ethereum').
+ * @returns Feed ID hex string or undefined if chain not supported.
+ */
+export declare function getNativeFeedId(chain: ChainType): string | undefined;
+//# sourceMappingURL=pyth-feed-ids.d.ts.map

package/dist/infrastructure/oracle/pyth-feed-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pyth-feed-ids.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/pyth-feed-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,sDAAsD;AACtD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAWpD,CAAC;AAgBH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEpE"}

package/dist/infrastructure/oracle/pyth-feed-ids.js

@@ -0,0 +1,44 @@
+// ---------------------------------------------------------------------------
+// Feed ID Map: cacheKey -> Pyth feed ID (hex, no 0x)
+// ---------------------------------------------------------------------------
+/** Hardcoded Pyth price feed IDs for major tokens. */
+export const PYTH_FEED_IDS = new Map([
+    // Native tokens
+    ['solana:native', 'ef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d'], // SOL/USD
+    ['ethereum:native', 'ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace'], // ETH/USD
+    // Solana SPL tokens
+    ['solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', 'eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a'], // USDC/USD
+    ['solana:Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB', '2b89b9dc8fdf9f34709a5b106b472f0f39bb6ca9ce04b0fd7f2e971688e2e53b'], // USDT/USD
+    // BTC (chain-agnostic feed, mapped for common BTC token addresses)
+    ['ethereum:native_btc', 'e62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43'], // BTC/USD
+]);
+// ---------------------------------------------------------------------------
+// Native token -> feed ID mapping
+// ---------------------------------------------------------------------------
+/** Map from ChainType to the native token's Pyth feed ID. */
+const NATIVE_FEED_MAP = new Map([
+    ['solana', 'ef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d'], // SOL/USD
+    ['ethereum', 'ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace'], // ETH/USD
+]);
+// ---------------------------------------------------------------------------
+// Public helpers
+// ---------------------------------------------------------------------------
+/**
+ * Look up a Pyth feed ID by cache key.
+ *
+ * @param cacheKey - Normalized cache key (e.g. `solana:native`, `ethereum:0xaddr`).
+ * @returns Feed ID hex string (no 0x prefix) or undefined if not registered.
+ */
+export function getFeedId(cacheKey) {
+    return PYTH_FEED_IDS.get(cacheKey);
+}
+/**
+ * Get the Pyth feed ID for a chain's native token.
+ *
+ * @param chain - Chain type ('solana' or 'ethereum').
+ * @returns Feed ID hex string or undefined if chain not supported.
+ */
+export function getNativeFeedId(chain) {
+    return NATIVE_FEED_MAP.get(chain);
+}
+//# sourceMappingURL=pyth-feed-ids.js.map

package/dist/infrastructure/oracle/pyth-feed-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pyth-feed-ids.js","sourceRoot":"","sources":["../../../src/infrastructure/oracle/pyth-feed-ids.ts"],"names":[],"mappings":"AAeA,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAgC,IAAI,GAAG,CAAC;IAChE,gBAAgB;IAChB,CAAC,eAAe,EAAE,kEAAkE,CAAC,EAAK,UAAU;IACpG,CAAC,iBAAiB,EAAE,kEAAkE,CAAC,EAAI,UAAU;IAErG,oBAAoB;IACpB,CAAC,qDAAqD,EAAE,kEAAkE,CAAC,EAAE,WAAW;IACxI,CAAC,qDAAqD,EAAE,kEAAkE,CAAC,EAAG,WAAW;IAEzI,mEAAmE;IACnE,CAAC,qBAAqB,EAAE,kEAAkE,CAAC,EAAE,UAAU;CACxG,CAAC,CAAC;AAEH,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,eAAe,GAAmC,IAAI,GAAG,CAAC;IAC9D,CAAC,QAAQ,EAAE,kEAAkE,CAAC,EAAI,UAAU;IAC5F,CAAC,UAAU,EAAE,kEAAkE,CAAC,EAAG,UAAU;CAC9F,CAAC,CAAC;AAEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/infrastructure/oracle/pyth-oracle.d.ts

@@ -0,0 +1,69 @@
+/**
+ * PythOracle: IPriceOracle implementation using Pyth Hermes REST API.
+ *
+ * Fetches real-time price data from the public Pyth Hermes instance
+ * (https://hermes.pyth.network) with zero-config (no API key required).
+ *
+ * Design decisions:
+ * - No internal cache: cache management is OracleChain's responsibility.
+ * - Feed IDs from hardcoded map (pyth-feed-ids.ts). Unknown tokens throw
+ *   PriceNotAvailableError to trigger OracleChain's CoinGecko fallback.
+ * - 5-second timeout via AbortSignal.timeout() (Node.js 22 built-in).
+ * - Price conversion: Number(price) * 10^expo for USD value.
+ */
+import type { ChainType, PriceInfo, CacheStats, IPriceOracle, TokenRef } from '@waiaas/core';
+export { PriceNotAvailableError } from './oracle-errors.js';
+/**
+ * Price oracle backed by the Pyth Hermes REST API.
+ *
+ * Implements IPriceOracle with pure API-call semantics (no caching).
+ * Supports single and batch price queries via the `/v2/updates/price/latest`
+ * endpoint.
+ */
+export declare class PythOracle implements IPriceOracle {
+    private static readonly HERMES_BASE_URL;
+    private static readonly TIMEOUT_MS;
+    private static readonly PRICE_TTL_MS;
+    /**
+     * Get price for a single token.
+     *
+     * @param token - Token reference with address, decimals, and chain.
+     * @returns PriceInfo with USD price, confidence, and metadata.
+     * @throws PriceNotAvailableError if token has no registered Pyth feed ID.
+     * @throws Error if Pyth API returns HTTP error or invalid response.
+     */
+    getPrice(token: TokenRef): Promise<PriceInfo>;
+    /**
+     * Get prices for multiple tokens in a single batch API call.
+     *
+     * Tokens without a registered feed ID are silently skipped (they will be
+     * handled by OracleChain's fallback).
+     *
+     * @param tokens - Array of token references.
+     * @returns Map from cache key to PriceInfo for tokens that have feed IDs.
+     */
+    getPrices(tokens: TokenRef[]): Promise<Map<string, PriceInfo>>;
+    /**
+     * Get native token price (SOL or ETH).
+     *
+     * @param chain - Chain type ('solana' or 'ethereum').
+     * @returns PriceInfo for the chain's native token.
+     * @throws PriceNotAvailableError if chain has no native feed mapping.
+     */
+    getNativePrice(chain: ChainType): Promise<PriceInfo>;
+    /**
+     * Get cache statistics.
+     *
+     * PythOracle does not manage its own cache (OracleChain handles caching),
+     * so all counters are zero.
+     */
+    getCacheStats(): CacheStats;
+    /**
+     * Convert a Pyth price feed to PriceInfo.
+     *
+     * Price formula: usdPrice = Number(price) * 10^expo
+     * Confidence: 1 - (confUsd / usdPrice) clamped to [0, 1]
+     */
+    private static convertFeedToPrice;
+}
+//# sourceMappingURL=pyth-oracle.d.ts.map

package/dist/infrastructure/oracle/pyth-oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pyth-oracle.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/pyth-oracle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAM7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AA8B5D;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACxE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAW;IAE/C;;;;;;;OAOG;IACG,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IA+BnD;;;;;;;;OAQG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAgDpE;;;;;;OAMG;IACG,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAK1D;;;;;OAKG;IACH,aAAa,IAAI,UAAU;IAc3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAoBlC"}