@waiaas/daemon 2.0.0-rc.1

package/dist/infrastructure/keystore/memory.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Sodium-native guarded memory management.
+ *
+ * Design reference: 26-keystore-spec.md section 4.
+ * - sodium_malloc: allocate guarded buffer with guard pages
+ * - sodium_mprotect_readonly: protect after writing
+ * - sodium_memzero: zero-fill before release
+ * - sodium_mprotect_noaccess: prevent any further access
+ *
+ * Falls back to regular Buffer if sodium-native is not available (with warning).
+ */
+/**
+ * Check if sodium-native is available.
+ * Caches the result after first check.
+ */
+export declare function isAvailable(): boolean;
+/**
+ * Allocate a guarded memory buffer of the given size.
+ *
+ * Uses sodium_malloc which places guard pages around the allocation,
+ * preventing buffer overflows from accessing adjacent memory.
+ *
+ * @param size - Number of bytes to allocate
+ * @returns Guarded buffer (default: no access until writeToGuarded)
+ */
+export declare function allocateGuarded(size: number): Buffer;
+/**
+ * Write source data into a guarded buffer and set it to readonly.
+ *
+ * @param target - Guarded buffer (from allocateGuarded)
+ * @param source - Data to copy into the guarded buffer
+ */
+export declare function writeToGuarded(target: Buffer, source: Buffer): void;
+/**
+ * Zero-fill and release a guarded buffer.
+ *
+ * After this call, the buffer contents are zeroed and the buffer
+ * is set to no-access mode. The buffer should not be used after this.
+ *
+ * Note: sodium_free is not exposed in sodium-native; rely on GC after zero+noaccess.
+ *
+ * @param buf - Guarded buffer to zero and release
+ */
+export declare function zeroAndRelease(buf: Buffer): void;
+//# sourceMappingURL=memory.d.ts.map

package/dist/infrastructure/keystore/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/keystore/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAerC;AAaD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAahD"}

package/dist/infrastructure/keystore/memory.js

@@ -0,0 +1,105 @@
+/**
+ * Sodium-native guarded memory management.
+ *
+ * Design reference: 26-keystore-spec.md section 4.
+ * - sodium_malloc: allocate guarded buffer with guard pages
+ * - sodium_mprotect_readonly: protect after writing
+ * - sodium_memzero: zero-fill before release
+ * - sodium_mprotect_noaccess: prevent any further access
+ *
+ * Falls back to regular Buffer if sodium-native is not available (with warning).
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+let sodium = null;
+let sodiumChecked = false;
+/**
+ * Check if sodium-native is available.
+ * Caches the result after first check.
+ */
+export function isAvailable() {
+    if (!sodiumChecked) {
+        try {
+            sodium = require('sodium-native');
+            sodiumChecked = true;
+        }
+        catch {
+            console.warn('[WAIaaS] sodium-native not available. Using regular Buffer for key storage. ' +
+                'Install sodium-native for guarded memory protection.');
+            sodium = null;
+            sodiumChecked = true;
+        }
+    }
+    return sodium !== null;
+}
+/**
+ * Get the sodium-native module, loading it if necessary.
+ * Returns null if not available.
+ */
+function getSodium() {
+    if (!sodiumChecked) {
+        isAvailable();
+    }
+    return sodium;
+}
+/**
+ * Allocate a guarded memory buffer of the given size.
+ *
+ * Uses sodium_malloc which places guard pages around the allocation,
+ * preventing buffer overflows from accessing adjacent memory.
+ *
+ * @param size - Number of bytes to allocate
+ * @returns Guarded buffer (default: no access until writeToGuarded)
+ */
+export function allocateGuarded(size) {
+    const s = getSodium();
+    if (s) {
+        return s.sodium_malloc(size);
+    }
+    // Fallback: regular buffer
+    return Buffer.alloc(size);
+}
+/**
+ * Write source data into a guarded buffer and set it to readonly.
+ *
+ * @param target - Guarded buffer (from allocateGuarded)
+ * @param source - Data to copy into the guarded buffer
+ */
+export function writeToGuarded(target, source) {
+    const s = getSodium();
+    if (s) {
+        s.sodium_mprotect_readwrite(target);
+        source.copy(target);
+        s.sodium_mprotect_readonly(target);
+    }
+    else {
+        source.copy(target);
+    }
+}
+/**
+ * Zero-fill and release a guarded buffer.
+ *
+ * After this call, the buffer contents are zeroed and the buffer
+ * is set to no-access mode. The buffer should not be used after this.
+ *
+ * Note: sodium_free is not exposed in sodium-native; rely on GC after zero+noaccess.
+ *
+ * @param buf - Guarded buffer to zero and release
+ */
+export function zeroAndRelease(buf) {
+    const s = getSodium();
+    if (s) {
+        try {
+            s.sodium_mprotect_readwrite(buf);
+        }
+        catch {
+            // Buffer may already be in a writable state
+        }
+        s.sodium_memzero(buf);
+        s.sodium_mprotect_noaccess(buf);
+    }
+    else {
+        buf.fill(0);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/infrastructure/keystore/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/infrastructure/keystore/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,IAAI,MAAM,GAAwB,IAAI,CAAC;AACvC,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,OAAO,CAAC,eAAe,CAAiB,CAAC;YAClD,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CACV,8EAA8E;gBAC5E,sDAAsD,CACzD,CAAC;YACF,MAAM,GAAG,IAAI,CAAC;YACd,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,KAAK,IAAI,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS;IAChB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,WAAW,EAAE,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,CAAC;QACN,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,2BAA2B;IAC3B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,MAAc;IAC3D,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,CAAC;QACN,CAAC,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,CAAC;QACN,IAAI,CAAC;YACH,CAAC,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;QACD,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/infrastructure/oracle/coingecko-forex.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CoinGecko-based forex rate provider.
+ *
+ * Queries CoinGecko's `/simple/price?ids=tether&vs_currencies=...` endpoint
+ * to get USD -> fiat exchange rates. Uses USDT (tether) as USD proxy
+ * since CoinGecko doesn't provide direct forex rates.
+ *
+ * Rate limits: Same as CoinGecko Demo API (30 calls/min, 10,000/month).
+ * Shares API key with CoinGeckoOracle (crypto price oracle).
+ *
+ * This provider does NOT manage cache -- caching is handled by ForexRateService
+ * via InMemoryPriceCache (30-minute TTL).
+ */
+/**
+ * CoinGecko forex rate provider.
+ *
+ * Fetches fiat exchange rates using tether (USDT ~ 1 USD) as proxy.
+ * GET /simple/price?ids=tether&vs_currencies=krw,jpy,eur,...
+ *
+ * Returns Map<currencyCode, rate> where rate is 1 USD in target currency.
+ * Empty Map if API key is not configured (graceful degradation).
+ */
+export declare class CoinGeckoForexProvider {
+    private readonly apiKey;
+    constructor(apiKey: string);
+    /**
+     * Fetch forex rates for multiple currencies from CoinGecko.
+     *
+     * @param currencies - Array of uppercase currency codes (e.g. ['KRW', 'JPY']).
+     * @returns Map from currency code to exchange rate.
+     * @throws Error on HTTP errors (non-2xx status).
+     */
+    getRates(currencies: string[]): Promise<Map<string, number>>;
+}
+//# sourceMappingURL=coingecko-forex.d.ts.map

package/dist/infrastructure/oracle/coingecko-forex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-forex.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/coingecko-forex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C;;;;;;OAMG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAoCnE"}

package/dist/infrastructure/oracle/coingecko-forex.js

@@ -0,0 +1,69 @@
+/**
+ * CoinGecko-based forex rate provider.
+ *
+ * Queries CoinGecko's `/simple/price?ids=tether&vs_currencies=...` endpoint
+ * to get USD -> fiat exchange rates. Uses USDT (tether) as USD proxy
+ * since CoinGecko doesn't provide direct forex rates.
+ *
+ * Rate limits: Same as CoinGecko Demo API (30 calls/min, 10,000/month).
+ * Shares API key with CoinGeckoOracle (crypto price oracle).
+ *
+ * This provider does NOT manage cache -- caching is handled by ForexRateService
+ * via InMemoryPriceCache (30-minute TTL).
+ */
+/** CoinGecko Demo API base URL. */
+const BASE_URL = 'https://api.coingecko.com/api/v3';
+/** Request timeout in milliseconds. */
+const TIMEOUT_MS = 5000;
+/**
+ * CoinGecko forex rate provider.
+ *
+ * Fetches fiat exchange rates using tether (USDT ~ 1 USD) as proxy.
+ * GET /simple/price?ids=tether&vs_currencies=krw,jpy,eur,...
+ *
+ * Returns Map<currencyCode, rate> where rate is 1 USD in target currency.
+ * Empty Map if API key is not configured (graceful degradation).
+ */
+export class CoinGeckoForexProvider {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    /**
+     * Fetch forex rates for multiple currencies from CoinGecko.
+     *
+     * @param currencies - Array of uppercase currency codes (e.g. ['KRW', 'JPY']).
+     * @returns Map from currency code to exchange rate.
+     * @throws Error on HTTP errors (non-2xx status).
+     */
+    async getRates(currencies) {
+        // Graceful: no API key -> empty result (no throw)
+        if (!this.apiKey) {
+            return new Map();
+        }
+        if (currencies.length === 0) {
+            return new Map();
+        }
+        // CoinGecko vs_currencies expects lowercase
+        const vsCurrencies = currencies.map((c) => c.toLowerCase()).join(',');
+        const url = `${BASE_URL}/simple/price?ids=tether&vs_currencies=${vsCurrencies}`;
+        const res = await fetch(url, {
+            headers: { 'x-cg-demo-api-key': this.apiKey },
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            throw new Error(`CoinGecko forex API error: ${res.status} ${res.statusText}`);
+        }
+        const data = (await res.json());
+        const tetherData = data.tether ?? {};
+        const result = new Map();
+        for (const curr of currencies) {
+            const rate = tetherData[curr.toLowerCase()];
+            if (typeof rate === 'number' && rate > 0) {
+                result.set(curr, rate);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=coingecko-forex.js.map

package/dist/infrastructure/oracle/coingecko-forex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-forex.js","sourceRoot":"","sources":["../../../src/infrastructure/oracle/coingecko-forex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,mCAAmC;AACnC,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAEpD,uCAAuC;AACvC,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,UAAoB;QACjC,kDAAkD;QAClD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,CAAC;QAED,4CAA4C;QAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,GAAG,QAAQ,0CAA0C,YAAY,EAAE,CAAC;QAEhF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,mBAAmB,EAAE,IAAI,CAAC,MAAM,EAAE;YAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2C,CAAC;QAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,73 @@
+/**
+ * CoinGecko Demo API oracle implementation.
+ *
+ * Queries CoinGecko for SPL/ERC-20 token and native token (SOL/ETH) prices.
+ * Uses the Demo API with x-cg-demo-api-key header authentication.
+ *
+ * Rate limits: 30 calls/min (Demo tier), 10,000 calls/month.
+ *
+ * This oracle does NOT manage its own cache -- caching is handled by
+ * OracleChain via InMemoryPriceCache (v1.5 cache responsibility decision).
+ */
+import type { ChainType, PriceInfo, CacheStats, IPriceOracle, TokenRef } from '@waiaas/core';
+export { PriceNotAvailableError, CoinGeckoNotConfiguredError } from './oracle-errors.js';
+/**
+ * CoinGecko price oracle implementing IPriceOracle.
+ *
+ * Fetches prices from CoinGecko Demo API:
+ * - Token prices: GET /simple/token_price/{platformId}
+ * - Native prices: GET /simple/price
+ *
+ * Does not manage cache internally (OracleChain manages shared cache).
+ */
+export declare class CoinGeckoOracle implements IPriceOracle {
+    private readonly apiKey;
+    constructor(apiKey: string);
+    /**
+     * Get price for a single token.
+     *
+     * @param token - Token reference with address, chain, decimals.
+     * @returns PriceInfo with USD price from CoinGecko.
+     * @throws CoinGeckoNotConfiguredError if API key is empty.
+     * @throws PriceNotAvailableError if CoinGecko has no data for this token.
+     * @throws Error on HTTP errors (429, 500, etc).
+     */
+    getPrice(token: TokenRef): Promise<PriceInfo>;
+    /**
+     * Get prices for multiple tokens in batch.
+     *
+     * Groups tokens by chain and makes one API call per chain
+     * (comma-separated addresses). Native tokens are queried separately.
+     *
+     * Individual token failures are skipped (not included in result Map).
+     *
+     * @param tokens - Array of token references.
+     * @returns Map from cache key to PriceInfo.
+     */
+    getPrices(tokens: TokenRef[]): Promise<Map<string, PriceInfo>>;
+    /**
+     * Get native token price (SOL or ETH).
+     *
+     * @param chain - Chain type ('solana' or 'ethereum').
+     * @returns PriceInfo with native token USD price.
+     * @throws CoinGeckoNotConfiguredError if API key is empty.
+     * @throws PriceNotAvailableError if chain is unsupported or no data.
+     */
+    getNativePrice(chain: ChainType): Promise<PriceInfo>;
+    /**
+     * Get cache statistics.
+     *
+     * CoinGeckoOracle does not manage its own cache (OracleChain manages
+     * the shared InMemoryPriceCache), so all counters are zero.
+     */
+    getCacheStats(): CacheStats;
+    /** Throw if API key is not configured. */
+    private ensureConfigured;
+    /** Fetch JSON from CoinGecko API with timeout and API key header. */
+    private fetchJson;
+    /** Build a PriceInfo with coingecko source and 5-minute TTL. */
+    private buildPriceInfo;
+    /** Fetch batch token prices for a single chain and add to result map. */
+    private fetchBatchTokenPrices;
+}
+//# sourceMappingURL=coingecko-oracle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-oracle.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/coingecko-oracle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAM7F,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAWzF;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,YAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C;;;;;;;;OAQG;IACG,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAwCnD;;;;;;;;;;OAUG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IA6CpE;;;;;;;OAOG;IACG,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA4B1D;;;;;OAKG;IACH,aAAa,IAAI,UAAU;IAQ3B,0CAA0C;IAC1C,OAAO,CAAC,gBAAgB;IAMxB,qEAAqE;YACvD,SAAS;IAavB,gEAAgE;IAChE,OAAO,CAAC,cAAc;IAWtB,yEAAyE;YAC3D,qBAAqB;CAqCpC"}

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

@@ -0,0 +1,199 @@
+import { getCoinGeckoPlatform } from './coingecko-platform-ids.js';
+import { PriceNotAvailableError, CoinGeckoNotConfiguredError } from './oracle-errors.js';
+import { buildCacheKey } from './price-cache.js';
+// Re-export error classes for consumer convenience
+export { PriceNotAvailableError, CoinGeckoNotConfiguredError } from './oracle-errors.js';
+/** CoinGecko Demo API base URL. */
+const BASE_URL = 'https://api.coingecko.com/api/v3';
+/** Request timeout in milliseconds. */
+const TIMEOUT_MS = 5000;
+/** Price TTL in milliseconds (5 minutes). */
+const PRICE_TTL_MS = 5 * 60 * 1000;
+/**
+ * CoinGecko price oracle implementing IPriceOracle.
+ *
+ * Fetches prices from CoinGecko Demo API:
+ * - Token prices: GET /simple/token_price/{platformId}
+ * - Native prices: GET /simple/price
+ *
+ * Does not manage cache internally (OracleChain manages shared cache).
+ */
+export class CoinGeckoOracle {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    /**
+     * Get price for a single token.
+     *
+     * @param token - Token reference with address, chain, decimals.
+     * @returns PriceInfo with USD price from CoinGecko.
+     * @throws CoinGeckoNotConfiguredError if API key is empty.
+     * @throws PriceNotAvailableError if CoinGecko has no data for this token.
+     * @throws Error on HTTP errors (429, 500, etc).
+     */
+    async getPrice(token) {
+        this.ensureConfigured();
+        // Delegate native tokens to getNativePrice
+        if (token.address === 'native') {
+            return this.getNativePrice(token.chain);
+        }
+        const platform = getCoinGeckoPlatform(token.chain);
+        if (!platform) {
+            throw new PriceNotAvailableError(`Unsupported chain for CoinGecko: ${token.chain}`);
+        }
+        // EVM addresses must be lowercased for CoinGecko API
+        const address = token.chain === 'ethereum'
+            ? token.address.toLowerCase()
+            : token.address;
+        const url = `${BASE_URL}/simple/token_price/${platform.platformId}` +
+            `?contract_addresses=${address}` +
+            `&vs_currencies=usd` +
+            `&include_last_updated_at=true`;
+        const data = await this.fetchJson(url);
+        // CoinGecko returns EVM addresses lowercased; Solana addresses are returned as-is
+        const lookupKey = token.chain === 'ethereum' ? address.toLowerCase() : address;
+        const tokenData = data[lookupKey];
+        if (!tokenData?.usd) {
+            throw new PriceNotAvailableError(`CoinGecko returned no price for ${token.symbol ?? token.address} on ${token.chain}`);
+        }
+        return this.buildPriceInfo(tokenData.usd);
+    }
+    /**
+     * Get prices for multiple tokens in batch.
+     *
+     * Groups tokens by chain and makes one API call per chain
+     * (comma-separated addresses). Native tokens are queried separately.
+     *
+     * Individual token failures are skipped (not included in result Map).
+     *
+     * @param tokens - Array of token references.
+     * @returns Map from cache key to PriceInfo.
+     */
+    async getPrices(tokens) {
+        this.ensureConfigured();
+        const result = new Map();
+        // Separate native and non-native tokens
+        const nativeTokens = [];
+        const tokensByChain = new Map();
+        for (const token of tokens) {
+            if (token.address === 'native') {
+                nativeTokens.push(token);
+            }
+            else {
+                const list = tokensByChain.get(token.chain) ?? [];
+                list.push(token);
+                tokensByChain.set(token.chain, list);
+            }
+        }
+        // Batch query per chain (comma-separated addresses)
+        const batchPromises = [];
+        for (const [chain, chainTokens] of tokensByChain) {
+            batchPromises.push(this.fetchBatchTokenPrices(chain, chainTokens, result));
+        }
+        // Native token queries
+        for (const token of nativeTokens) {
+            batchPromises.push(this.getNativePrice(token.chain)
+                .then((price) => {
+                result.set(buildCacheKey(token.chain, 'native'), price);
+            })
+                .catch(() => {
+                // Skip failed native price queries
+            }));
+        }
+        await Promise.all(batchPromises);
+        return result;
+    }
+    /**
+     * Get native token price (SOL or ETH).
+     *
+     * @param chain - Chain type ('solana' or 'ethereum').
+     * @returns PriceInfo with native token USD price.
+     * @throws CoinGeckoNotConfiguredError if API key is empty.
+     * @throws PriceNotAvailableError if chain is unsupported or no data.
+     */
+    async getNativePrice(chain) {
+        this.ensureConfigured();
+        const platform = getCoinGeckoPlatform(chain);
+        if (!platform) {
+            throw new PriceNotAvailableError(`Unsupported chain for CoinGecko native price: ${chain}`);
+        }
+        const url = `${BASE_URL}/simple/price` +
+            `?ids=${platform.nativeCoinId}` +
+            `&vs_currencies=usd` +
+            `&include_last_updated_at=true`;
+        const data = await this.fetchJson(url);
+        const coinData = data[platform.nativeCoinId];
+        if (!coinData?.usd) {
+            throw new PriceNotAvailableError(`CoinGecko returned no native price for ${chain}`);
+        }
+        return this.buildPriceInfo(coinData.usd);
+    }
+    /**
+     * Get cache statistics.
+     *
+     * CoinGeckoOracle does not manage its own cache (OracleChain manages
+     * the shared InMemoryPriceCache), so all counters are zero.
+     */
+    getCacheStats() {
+        return { hits: 0, misses: 0, staleHits: 0, size: 0, evictions: 0 };
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /** Throw if API key is not configured. */
+    ensureConfigured() {
+        if (!this.apiKey) {
+            throw new CoinGeckoNotConfiguredError();
+        }
+    }
+    /** Fetch JSON from CoinGecko API with timeout and API key header. */
+    async fetchJson(url) {
+        const res = await fetch(url, {
+            headers: { 'x-cg-demo-api-key': this.apiKey },
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            throw new Error(`CoinGecko API error: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    }
+    /** Build a PriceInfo with coingecko source and 5-minute TTL. */
+    buildPriceInfo(usdPrice) {
+        const now = Date.now();
+        return {
+            usdPrice,
+            source: 'coingecko',
+            fetchedAt: now,
+            expiresAt: now + PRICE_TTL_MS,
+            isStale: false,
+        };
+    }
+    /** Fetch batch token prices for a single chain and add to result map. */
+    async fetchBatchTokenPrices(chain, tokens, result) {
+        const platform = getCoinGeckoPlatform(chain);
+        if (!platform)
+            return;
+        const addresses = tokens.map((t) => chain === 'ethereum' ? t.address.toLowerCase() : t.address);
+        const url = `${BASE_URL}/simple/token_price/${platform.platformId}` +
+            `?contract_addresses=${addresses.join(',')}` +
+            `&vs_currencies=usd` +
+            `&include_last_updated_at=true`;
+        try {
+            const data = await this.fetchJson(url);
+            for (const token of tokens) {
+                const addr = chain === 'ethereum'
+                    ? token.address.toLowerCase()
+                    : token.address;
+                const tokenData = data[addr];
+                if (tokenData?.usd) {
+                    result.set(buildCacheKey(chain, token.address), this.buildPriceInfo(tokenData.usd));
+                }
+            }
+        }
+        catch {
+            // Skip failed batch queries (individual token failures)
+        }
+    }
+}
+//# sourceMappingURL=coingecko-oracle.js.map

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

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

package/dist/infrastructure/oracle/coingecko-platform-ids.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CoinGecko platform ID and native coin ID mapping.
+ *
+ * Maps WAIaaS ChainType to CoinGecko API identifiers:
+ * - platformId: used in /simple/token_price/{platformId} path
+ * - nativeCoinId: used in /simple/price?ids={nativeCoinId} path
+ *
+ * v1.5: Only solana and ethereum. L2 networks (Polygon, Arbitrum, etc.)
+ * will be added when TokenRef gains a network field.
+ */
+/** CoinGecko platform configuration for a chain. */
+export interface CoinGeckoPlatform {
+    /** Platform ID for /simple/token_price/{platformId} endpoint. */
+    platformId: string;
+    /** Native coin ID for /simple/price?ids={nativeCoinId} endpoint. */
+    nativeCoinId: string;
+}
+/**
+ * Map from WAIaaS ChainType to CoinGecko platform/coin IDs.
+ *
+ * Currently supports solana and ethereum (mainnet).
+ * L2 platformIds (polygon-pos, arbitrum-one, etc.) are out of v1.5 scope.
+ */
+export declare const COINGECKO_PLATFORM_MAP: Record<string, CoinGeckoPlatform>;
+/**
+ * Look up CoinGecko platform config for a chain.
+ *
+ * @param chain - WAIaaS ChainType ('solana' | 'ethereum').
+ * @returns CoinGeckoPlatform if supported, undefined otherwise.
+ */
+export declare function getCoinGeckoPlatform(chain: string): CoinGeckoPlatform | undefined;
+//# sourceMappingURL=coingecko-platform-ids.d.ts.map

package/dist/infrastructure/oracle/coingecko-platform-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-platform-ids.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/oracle/coingecko-platform-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAGpE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEjF"}

package/dist/infrastructure/oracle/coingecko-platform-ids.js

@@ -0,0 +1,30 @@
+/**
+ * CoinGecko platform ID and native coin ID mapping.
+ *
+ * Maps WAIaaS ChainType to CoinGecko API identifiers:
+ * - platformId: used in /simple/token_price/{platformId} path
+ * - nativeCoinId: used in /simple/price?ids={nativeCoinId} path
+ *
+ * v1.5: Only solana and ethereum. L2 networks (Polygon, Arbitrum, etc.)
+ * will be added when TokenRef gains a network field.
+ */
+/**
+ * Map from WAIaaS ChainType to CoinGecko platform/coin IDs.
+ *
+ * Currently supports solana and ethereum (mainnet).
+ * L2 platformIds (polygon-pos, arbitrum-one, etc.) are out of v1.5 scope.
+ */
+export const COINGECKO_PLATFORM_MAP = {
+    solana: { platformId: 'solana', nativeCoinId: 'solana' },
+    ethereum: { platformId: 'ethereum', nativeCoinId: 'ethereum' },
+};
+/**
+ * Look up CoinGecko platform config for a chain.
+ *
+ * @param chain - WAIaaS ChainType ('solana' | 'ethereum').
+ * @returns CoinGeckoPlatform if supported, undefined otherwise.
+ */
+export function getCoinGeckoPlatform(chain) {
+    return COINGECKO_PLATFORM_MAP[chain];
+}
+//# sourceMappingURL=coingecko-platform-ids.js.map

package/dist/infrastructure/oracle/coingecko-platform-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-platform-ids.js","sourceRoot":"","sources":["../../../src/infrastructure/oracle/coingecko-platform-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;IACxD,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE;CAC/D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}