@revealui/services 0.1.0 → 0.2.1

package/dist/revealcoin/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/revealcoin/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAgInE,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4ChF;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA6D5D;AAMD,eAAO,MAAM,sBAAsB,kBAAuB,CAAC;AAC3D,eAAO,MAAM,wBAAwB;;;;CAAyB,CAAC;AAC/D,eAAO,MAAM,cAAc;;;;CAAe,CAAC;AAC3C,eAAO,MAAM,qBAAqB,QAAO,OAAO,CAAC,IAAI,CAAiC,CAAC;AACvF,eAAO,MAAM,iBAAiB,QAAO,IAGpC,CAAC"}

package/dist/revealcoin/client.js

@@ -0,0 +1,211 @@
+/**
+ * RevealCoin RPC Client
+ *
+ * Provides balance queries and payment verification for RevealCoin (RVUI)
+ * on the Solana blockchain. Uses circuit breaker + retry pattern mirroring
+ * the Stripe client in packages/services/src/stripe/stripeClient.ts.
+ */
+import { RVUI_MINT_ADDRESSES, RVUI_TOKEN_CONFIG, RVUI_TOKEN_PROGRAM, } from '@revealui/contracts';
+import { createLogger } from '@revealui/core/observability/logger';
+import { address, createSolanaRpc, signature } from '@solana/kit';
+import { getRevealCoinConfig, resolveRpcUrl } from './config.js';
+import { DbCircuitBreaker } from '../stripe/db-circuit-breaker.js';
+const logger = createLogger({ service: 'RevealCoin' });
+// =============================================================================
+// Circuit Breaker (DB-backed, shared across API instances)
+// =============================================================================
+const CIRCUIT_BREAKER_CONFIG = {
+    failureThreshold: 5,
+    resetTimeout: 30_000,
+    successThreshold: 2,
+};
+const solanaCircuitBreaker = new DbCircuitBreaker('solana-rpc', {
+    failureThreshold: CIRCUIT_BREAKER_CONFIG.failureThreshold,
+    successThreshold: CIRCUIT_BREAKER_CONFIG.successThreshold,
+    resetTimeout: CIRCUIT_BREAKER_CONFIG.resetTimeout,
+});
+// =============================================================================
+// Retry Configuration
+// =============================================================================
+const RETRY_CONFIG = {
+    maxAttempts: 3,
+    backoff: [200, 500, 1000],
+    timeout: 15_000,
+};
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withTimeout(promise, timeoutMs) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Solana RPC timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+}
+// =============================================================================
+// Resilient RPC Wrapper
+// =============================================================================
+async function callWithResilience(operation, operationName) {
+    if (await solanaCircuitBreaker.isOpen()) {
+        logger.error('Solana RPC circuit breaker is OPEN', undefined, {
+            operation: operationName,
+            state: 'open',
+        });
+        throw new Error('Solana RPC circuit breaker is OPEN. Service unavailable.');
+    }
+    let lastError;
+    for (let attempt = 0; attempt < RETRY_CONFIG.maxAttempts; attempt++) {
+        try {
+            const result = await withTimeout(operation(), RETRY_CONFIG.timeout);
+            await solanaCircuitBreaker.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+            const isRetryable = error instanceof Error &&
+                (error.message.includes('timeout') ||
+                    error.message.includes('ECONNREFUSED') ||
+                    error.message.includes('ETIMEDOUT') ||
+                    error.message.includes('429') ||
+                    error.message.includes('503'));
+            if (!isRetryable) {
+                await solanaCircuitBreaker.recordFailure();
+                logger.error(`${operationName} failed (non-retryable)`, error instanceof Error ? error : new Error(String(error)), { operation: operationName, attempt: attempt + 1 });
+                throw error;
+            }
+            logger.warn(`${operationName} failed (retryable), retrying...`, {
+                operation: operationName,
+                attempt: attempt + 1,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (attempt < RETRY_CONFIG.maxAttempts - 1) {
+                const backoffMs = RETRY_CONFIG.backoff[attempt] ??
+                    RETRY_CONFIG.backoff[RETRY_CONFIG.backoff.length - 1] ??
+                    1000;
+                await sleep(backoffMs);
+            }
+        }
+    }
+    await solanaCircuitBreaker.recordFailure();
+    throw lastError instanceof Error
+        ? new Error(`${operationName} failed after ${RETRY_CONFIG.maxAttempts} attempts: ${lastError.message}`)
+        : new Error(`${operationName} failed after ${RETRY_CONFIG.maxAttempts} attempts`);
+}
+// =============================================================================
+// Connection Management
+// =============================================================================
+let _rpc = null;
+let _rpcUrl = null;
+function getRpc() {
+    const rpcUrl = resolveRpcUrl();
+    if (_rpc && _rpcUrl === rpcUrl)
+        return _rpc;
+    _rpc = createSolanaRpc(rpcUrl);
+    _rpcUrl = rpcUrl;
+    return _rpc;
+}
+/**
+ * Get the RVUI balance for a wallet address.
+ *
+ * Queries the Token-2022 Associated Token Account for the RVUI mint.
+ * Returns zero balance if the ATA does not exist (wallet has never held RVUI).
+ */
+export async function getRvuiBalance(walletAddress) {
+    return callWithResilience(async () => {
+        const rpc = getRpc();
+        const config = getRevealCoinConfig();
+        const mintAddress = RVUI_MINT_ADDRESSES[config.network];
+        if (!mintAddress) {
+            throw new Error(`RVUI not deployed on ${config.network}`);
+        }
+        const wallet = address(walletAddress);
+        const mint = address(mintAddress);
+        const response = await rpc
+            .getTokenAccountsByOwner(wallet, { mint }, { encoding: 'jsonParsed', commitment: config.queryCommitment })
+            .send();
+        if (response.value.length === 0) {
+            return { raw: 0n, formatted: '0', uiAmount: 0 };
+        }
+        const firstAccount = response.value[0];
+        if (!firstAccount) {
+            return { raw: 0n, formatted: '0', uiAmount: 0 };
+        }
+        const accountData = firstAccount.account.data;
+        const raw = BigInt(accountData.parsed.info.tokenAmount.amount);
+        const divisor = 10 ** RVUI_TOKEN_CONFIG.decimals;
+        const uiAmount = Number(raw) / divisor;
+        return {
+            raw,
+            formatted: uiAmount.toLocaleString(undefined, {
+                minimumFractionDigits: 0,
+                maximumFractionDigits: RVUI_TOKEN_CONFIG.decimals,
+            }),
+            uiAmount,
+        };
+    }, 'getRvuiBalance');
+}
+/**
+ * Verify an RVUI payment transaction on-chain.
+ *
+ * Confirms that a Solana transaction contains a Token-2022 transfer of
+ * the correct amount to the expected recipient for the RVUI mint.
+ *
+ * Uses `finalized` commitment to prevent rollback exploits.
+ */
+export async function verifyRvuiPayment(txSignature, expectedAmountRaw, expectedRecipient) {
+    return callWithResilience(async () => {
+        const rpc = getRpc();
+        const config = getRevealCoinConfig();
+        const mintAddress = RVUI_MINT_ADDRESSES[config.network];
+        if (!mintAddress) {
+            return { valid: false, error: `RVUI not deployed on ${config.network}` };
+        }
+        const tx = await rpc
+            .getTransaction(signature(txSignature), {
+            commitment: config.paymentCommitment,
+            encoding: 'jsonParsed',
+            maxSupportedTransactionVersion: 0,
+        })
+            .send();
+        if (!tx) {
+            return { valid: false, error: 'Transaction not found or not yet finalized' };
+        }
+        if (tx.meta?.err) {
+            return { valid: false, error: `Transaction failed: ${JSON.stringify(tx.meta.err)}` };
+        }
+        // Parse token balance changes from transaction meta
+        const preBalances = tx.meta?.preTokenBalances ?? [];
+        const postBalances = tx.meta?.postTokenBalances ?? [];
+        // In @solana/kit, addresses are strings — no PublicKey class needed
+        const recipientPost = postBalances.find((b) => b.mint === mintAddress &&
+            b.owner === expectedRecipient &&
+            b.programId === RVUI_TOKEN_PROGRAM);
+        const recipientPre = preBalances.find((b) => b.mint === mintAddress &&
+            b.owner === expectedRecipient &&
+            b.programId === RVUI_TOKEN_PROGRAM);
+        if (!recipientPost) {
+            return { valid: false, error: 'Recipient did not receive RVUI tokens in this transaction' };
+        }
+        const preAmount = BigInt(recipientPre?.uiTokenAmount.amount ?? '0');
+        const postAmount = BigInt(recipientPost.uiTokenAmount.amount);
+        const received = postAmount - preAmount;
+        if (received < expectedAmountRaw) {
+            return {
+                valid: false,
+                error: `Insufficient payment: expected ${expectedAmountRaw}, received ${received}`,
+            };
+        }
+        return { valid: true };
+    }, 'verifyRvuiPayment');
+}
+// =============================================================================
+// Test-only exports
+// =============================================================================
+export const __solanaCircuitBreaker = solanaCircuitBreaker;
+export const __CIRCUIT_BREAKER_CONFIG = CIRCUIT_BREAKER_CONFIG;
+export const __RETRY_CONFIG = RETRY_CONFIG;
+export const __resetCircuitBreaker = () => solanaCircuitBreaker.reset();
+export const __resetConnection = () => {
+    _rpc = null;
+    _rpcUrl = null;
+};
+//# sourceMappingURL=client.js.map

package/dist/revealcoin/client.js.map

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

package/dist/revealcoin/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * RevealCoin RPC Configuration
+ *
+ * Parameterized configuration for Solana RPC connections and payment
+ * verification. All thresholds are overridable for testing.
+ */
+import type { SolanaNetwork } from '@revealui/contracts';
+export interface RevealCoinConfig {
+    /** Solana network to connect to. Default: 'devnet' */
+    network: SolanaNetwork;
+    /** Solana RPC URL override. If empty, uses default cluster URL for the network. */
+    rpcUrl: string;
+    /** Commitment level for balance queries. Default: 'confirmed' */
+    queryCommitment: 'processed' | 'confirmed' | 'finalized';
+    /** Commitment level for payment verification. Default: 'finalized' */
+    paymentCommitment: 'confirmed' | 'finalized';
+    /** Whether RVUI payments are enabled. Default: false */
+    enabled: boolean;
+    /** Wallet address to receive RVUI payments. Required when enabled. */
+    receivingWallet: string;
+    /** Balance poll interval in milliseconds. Default: 60_000 */
+    pollIntervalMs: number;
+}
+/** Read RevealCoin configuration from environment variables. */
+export declare function getRevealCoinConfig(): RevealCoinConfig;
+/** Override configuration (for testing or runtime reconfiguration). */
+export declare function configureRevealCoin(overrides: Partial<RevealCoinConfig>): void;
+/** Reset configuration to defaults. */
+export declare function resetRevealCoinConfig(): void;
+/** Resolve the RPC URL for the current network configuration. */
+export declare function resolveRpcUrl(cfg?: RevealCoinConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/revealcoin/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/revealcoin/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,eAAe,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IACzD,sEAAsE;IACtE,iBAAiB,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;CACxB;AAkBD,gEAAgE;AAChE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAUtD;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAE9E;AAED,uCAAuC;AACvC,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAYD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAI5D"}

package/dist/revealcoin/config.js

@@ -0,0 +1,54 @@
+/**
+ * RevealCoin RPC Configuration
+ *
+ * Parameterized configuration for Solana RPC connections and payment
+ * verification. All thresholds are overridable for testing.
+ */
+const DEFAULT_CONFIG = {
+    network: 'devnet',
+    rpcUrl: '',
+    queryCommitment: 'confirmed',
+    paymentCommitment: 'finalized',
+    enabled: false,
+    receivingWallet: '',
+    pollIntervalMs: 60_000,
+};
+let config = { ...DEFAULT_CONFIG };
+// =============================================================================
+// Public API
+// =============================================================================
+/** Read RevealCoin configuration from environment variables. */
+export function getRevealCoinConfig() {
+    const network = process.env.SOLANA_NETWORK ?? DEFAULT_CONFIG.network;
+    return {
+        ...config,
+        network,
+        rpcUrl: process.env.SOLANA_RPC_URL ?? config.rpcUrl,
+        enabled: process.env.RVUI_PAYMENTS_ENABLED === 'true',
+        receivingWallet: process.env.RVUI_RECEIVING_WALLET ?? config.receivingWallet,
+    };
+}
+/** Override configuration (for testing or runtime reconfiguration). */
+export function configureRevealCoin(overrides) {
+    config = { ...DEFAULT_CONFIG, ...overrides };
+}
+/** Reset configuration to defaults. */
+export function resetRevealCoinConfig() {
+    config = { ...DEFAULT_CONFIG };
+}
+// =============================================================================
+// RPC URL Resolution
+// =============================================================================
+const CLUSTER_URLS = {
+    devnet: 'https://api.devnet.solana.com',
+    testnet: 'https://api.testnet.solana.com',
+    'mainnet-beta': 'https://api.mainnet-beta.solana.com',
+};
+/** Resolve the RPC URL for the current network configuration. */
+export function resolveRpcUrl(cfg) {
+    const c = cfg ?? getRevealCoinConfig();
+    if (c.rpcUrl)
+        return c.rpcUrl;
+    return CLUSTER_URLS[c.network] ?? 'https://api.devnet.solana.com';
+}
+//# sourceMappingURL=config.js.map

package/dist/revealcoin/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/revealcoin/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,MAAM,cAAc,GAAqB;IACvC,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,EAAE;IACV,eAAe,EAAE,WAAW;IAC5B,iBAAiB,EAAE,WAAW;IAC9B,OAAO,EAAE,KAAK;IACd,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE,MAAM;CACvB,CAAC;AAEF,IAAI,MAAM,GAAqB,EAAE,GAAG,cAAc,EAAE,CAAC;AAErD,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,gEAAgE;AAChE,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAI,OAAO,CAAC,GAAG,CAAC,cAAgC,IAAI,cAAc,CAAC,OAAO,CAAC;IAExF,OAAO;QACL,GAAG,MAAM;QACT,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM;QACnD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM;QACrD,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,MAAM,CAAC,eAAe;KAC7E,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,SAAoC;IACtE,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,SAAS,EAAE,CAAC;AAC/C,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,MAAM,YAAY,GAAkC;IAClD,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,gCAAgC;IACzC,cAAc,EAAE,qCAAqC;CACtD,CAAC;AAEF,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,GAAsB;IAClD,MAAM,CAAC,GAAG,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACvC,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IAC9B,OAAO,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,+BAA+B,CAAC;AACpE,CAAC"}

package/dist/revealcoin/index.d.ts

@@ -0,0 +1,5 @@
+export { configureRevealCoin, getRevealCoinConfig, resetRevealCoinConfig, resolveRpcUrl, type RevealCoinConfig, } from './config.js';
+export { getRvuiBalance, type RvuiBalance, verifyRvuiPayment, } from './client.js';
+export { configureSafeguards, getSafeguardsConfig, getTwapPrice, isDuplicateTransaction, isDiscountCapExceeded, isPaymentOverMaximum, isPriceCircuitBreakerOpen, isWalletRateLimited, recordPayment, recordPriceSnapshot, resetSafeguardsConfig, type RevealCoinSafeguardsConfig, type SafeguardCheckResult, validatePayment, } from './safeguards.js';
+export { configurePriceOracle, fetchRvuiPrice, getPriceOracleConfig, isPriceOracleRunning, type PriceOracleConfig, recordPriceFromJupiter, rvuiToUsd, startPriceOracle, stopPriceOracle, usdToRvui, } from './oracle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/revealcoin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/revealcoin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/revealcoin/index.js

@@ -0,0 +1,5 @@
+export { configureRevealCoin, getRevealCoinConfig, resetRevealCoinConfig, resolveRpcUrl, } from './config.js';
+export { getRvuiBalance, verifyRvuiPayment, } from './client.js';
+export { configureSafeguards, getSafeguardsConfig, getTwapPrice, isDuplicateTransaction, isDiscountCapExceeded, isPaymentOverMaximum, isPriceCircuitBreakerOpen, isWalletRateLimited, recordPayment, recordPriceSnapshot, resetSafeguardsConfig, validatePayment, } from './safeguards.js';
+export { configurePriceOracle, fetchRvuiPrice, getPriceOracleConfig, isPriceOracleRunning, recordPriceFromJupiter, rvuiToUsd, startPriceOracle, stopPriceOracle, usdToRvui, } from './oracle.js';
+//# sourceMappingURL=index.js.map

package/dist/revealcoin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/revealcoin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EAEd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EAGrB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EAEpB,sBAAsB,EACtB,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/revealcoin/oracle.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Jupiter Price Oracle for RVUI → USD conversion.
+ *
+ * Fetches live RVUI price from Jupiter Price API v3, records snapshots
+ * to the database for TWAP calculation, and provides a polling loop
+ * for continuous price monitoring.
+ *
+ * Per whitepaper Section 9.4:
+ *   - Source: Jupiter aggregator price feed (RVUI/USDC pair)
+ *   - Window: 1-hour TWAP to smooth volatility
+ *   - Update frequency: Every 60 seconds
+ *   - Fallback: If oracle is unavailable, fiat pricing applies (no RVUI discount)
+ *
+ * Requires JUPITER_API_KEY env var (free tier: 1 RPS, sufficient for 60s polling).
+ */
+export interface PriceOracleConfig {
+    /** Jupiter Price API v3 endpoint. */
+    apiUrl: string;
+    /** Jupiter API key (required). Free tier at portal.jup.ag */
+    apiKey: string;
+    /** Polling interval in milliseconds. Default: 60_000 (60 seconds) */
+    pollIntervalMs: number;
+    /** Request timeout in milliseconds. Default: 10_000 */
+    requestTimeoutMs: number;
+    /** Maximum consecutive failures before stopping. Default: 10 */
+    maxConsecutiveFailures: number;
+}
+export declare function configurePriceOracle(overrides: Partial<PriceOracleConfig>): void;
+export declare function getPriceOracleConfig(): PriceOracleConfig;
+/**
+ * Fetch the current RVUI price in USD from Jupiter Price API v3.
+ *
+ * Returns null if:
+ * - No API key configured
+ * - RVUI mint not found on the active network
+ * - Jupiter returns no price data (no recent trades)
+ * - Network/API error
+ */
+export declare function fetchRvuiPrice(): Promise<{
+    priceUsd: number;
+    liquidity: number;
+    blockId: number | null;
+    priceChange24h: number | null;
+} | null>;
+/**
+ * Fetch the current price and record a snapshot for TWAP calculation.
+ *
+ * Returns the recorded price or null if fetch failed.
+ */
+export declare function recordPriceFromJupiter(): Promise<number | null>;
+/**
+ * Convert an RVUI amount to its USD equivalent using TWAP.
+ *
+ * Returns null if no TWAP price is available (oracle offline or
+ * insufficient snapshots). Callers should fall back to fiat-only pricing.
+ */
+export declare function rvuiToUsd(rvuiAmount: number): Promise<number | null>;
+/**
+ * Convert a USD amount to the equivalent RVUI using TWAP.
+ *
+ * Returns null if no TWAP price is available.
+ */
+export declare function usdToRvui(usdAmount: number): Promise<number | null>;
+/**
+ * Start the price oracle polling loop.
+ *
+ * Fetches and records RVUI price at the configured interval.
+ * Stops automatically after maxConsecutiveFailures.
+ *
+ * Call stopPriceOracle() to stop manually.
+ */
+export declare function startPriceOracle(): void;
+/**
+ * Stop the price oracle polling loop.
+ */
+export declare function stopPriceOracle(): void;
+/**
+ * Check if the price oracle is currently running.
+ */
+export declare function isPriceOracleRunning(): boolean;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/revealcoin/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/revealcoin/oracle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAYD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAEhF;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD;AAqBD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,IAAI,CAAC,CAyDR;AAMD;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAarE;AAMD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAI1E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIzE;AASD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CA0BvC;AAkBD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAMtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}

package/dist/revealcoin/oracle.js

@@ -0,0 +1,211 @@
+/**
+ * Jupiter Price Oracle for RVUI → USD conversion.
+ *
+ * Fetches live RVUI price from Jupiter Price API v3, records snapshots
+ * to the database for TWAP calculation, and provides a polling loop
+ * for continuous price monitoring.
+ *
+ * Per whitepaper Section 9.4:
+ *   - Source: Jupiter aggregator price feed (RVUI/USDC pair)
+ *   - Window: 1-hour TWAP to smooth volatility
+ *   - Update frequency: Every 60 seconds
+ *   - Fallback: If oracle is unavailable, fiat pricing applies (no RVUI discount)
+ *
+ * Requires JUPITER_API_KEY env var (free tier: 1 RPS, sufficient for 60s polling).
+ */
+import { RVUI_MINT_ADDRESSES } from '@revealui/contracts';
+import { createLogger } from '@revealui/core/observability/logger';
+import { getRevealCoinConfig } from './config.js';
+import { getTwapPrice, recordPriceSnapshot } from './safeguards.js';
+const logger = createLogger({ service: 'RevealCoin:Oracle' });
+const DEFAULT_CONFIG = {
+    apiUrl: 'https://api.jup.ag/price/v3',
+    apiKey: '',
+    pollIntervalMs: 60_000,
+    requestTimeoutMs: 10_000,
+    maxConsecutiveFailures: 10,
+};
+let oracleConfig = { ...DEFAULT_CONFIG };
+export function configurePriceOracle(overrides) {
+    oracleConfig = { ...DEFAULT_CONFIG, ...overrides };
+}
+export function getPriceOracleConfig() {
+    return {
+        ...oracleConfig,
+        apiKey: process.env.JUPITER_API_KEY ?? oracleConfig.apiKey,
+    };
+}
+// =============================================================================
+// Price Fetching
+// =============================================================================
+/**
+ * Fetch the current RVUI price in USD from Jupiter Price API v3.
+ *
+ * Returns null if:
+ * - No API key configured
+ * - RVUI mint not found on the active network
+ * - Jupiter returns no price data (no recent trades)
+ * - Network/API error
+ */
+export async function fetchRvuiPrice() {
+    const config = getPriceOracleConfig();
+    if (!config.apiKey) {
+        logger.debug('Jupiter API key not configured, skipping price fetch');
+        return null;
+    }
+    const rvuiConfig = getRevealCoinConfig();
+    const mintAddress = RVUI_MINT_ADDRESSES[rvuiConfig.network];
+    if (!mintAddress) {
+        logger.warn('No RVUI mint address for network', { network: rvuiConfig.network });
+        return null;
+    }
+    try {
+        const url = `${config.apiUrl}?ids=${mintAddress}`;
+        const response = await fetch(url, {
+            headers: { 'x-api-key': config.apiKey },
+            signal: AbortSignal.timeout(config.requestTimeoutMs),
+        });
+        if (response.status === 429) {
+            logger.warn('Jupiter API rate limited');
+            return null;
+        }
+        if (response.status === 401) {
+            logger.error('Jupiter API key invalid or expired');
+            return null;
+        }
+        if (!response.ok) {
+            logger.warn('Jupiter API error', { status: response.status });
+            return null;
+        }
+        const data = (await response.json());
+        const entry = data[mintAddress];
+        if (!entry) {
+            // Token has no recent trades — no price available
+            logger.debug('No Jupiter price data for RVUI', { mint: mintAddress });
+            return null;
+        }
+        return {
+            priceUsd: entry.usdPrice,
+            liquidity: entry.liquidity,
+            blockId: entry.blockId,
+            priceChange24h: entry.priceChange24h,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        logger.warn('Failed to fetch RVUI price from Jupiter', { error: message });
+        return null;
+    }
+}
+// =============================================================================
+// Snapshot Recording
+// =============================================================================
+/**
+ * Fetch the current price and record a snapshot for TWAP calculation.
+ *
+ * Returns the recorded price or null if fetch failed.
+ */
+export async function recordPriceFromJupiter() {
+    const priceData = await fetchRvuiPrice();
+    if (!priceData)
+        return null;
+    await recordPriceSnapshot(priceData.priceUsd, 'jupiter-v3');
+    logger.debug('Recorded RVUI price snapshot', {
+        priceUsd: priceData.priceUsd,
+        liquidity: priceData.liquidity,
+        blockId: priceData.blockId,
+    });
+    return priceData.priceUsd;
+}
+// =============================================================================
+// RVUI → USD Conversion
+// =============================================================================
+/**
+ * Convert an RVUI amount to its USD equivalent using TWAP.
+ *
+ * Returns null if no TWAP price is available (oracle offline or
+ * insufficient snapshots). Callers should fall back to fiat-only pricing.
+ */
+export async function rvuiToUsd(rvuiAmount) {
+    const twap = await getTwapPrice();
+    if (twap === null)
+        return null;
+    return rvuiAmount * twap;
+}
+/**
+ * Convert a USD amount to the equivalent RVUI using TWAP.
+ *
+ * Returns null if no TWAP price is available.
+ */
+export async function usdToRvui(usdAmount) {
+    const twap = await getTwapPrice();
+    if (twap === null || twap === 0)
+        return null;
+    return usdAmount / twap;
+}
+// =============================================================================
+// Polling Loop
+// =============================================================================
+let pollTimer = null;
+let consecutiveFailures = 0;
+/**
+ * Start the price oracle polling loop.
+ *
+ * Fetches and records RVUI price at the configured interval.
+ * Stops automatically after maxConsecutiveFailures.
+ *
+ * Call stopPriceOracle() to stop manually.
+ */
+export function startPriceOracle() {
+    if (pollTimer) {
+        logger.warn('Price oracle already running');
+        return;
+    }
+    const config = getPriceOracleConfig();
+    if (!config.apiKey) {
+        logger.info('Jupiter API key not configured — price oracle disabled');
+        return;
+    }
+    consecutiveFailures = 0;
+    logger.info('Starting RVUI price oracle', {
+        intervalMs: config.pollIntervalMs,
+        apiUrl: config.apiUrl,
+    });
+    // Initial fetch
+    void tick(config);
+    pollTimer = setInterval(() => {
+        void tick(config);
+    }, config.pollIntervalMs);
+}
+async function tick(config) {
+    const price = await recordPriceFromJupiter();
+    if (price === null) {
+        consecutiveFailures++;
+        if (consecutiveFailures >= config.maxConsecutiveFailures) {
+            logger.error('Price oracle stopped — too many consecutive failures', undefined, {
+                failures: consecutiveFailures,
+            });
+            stopPriceOracle();
+        }
+    }
+    else {
+        consecutiveFailures = 0;
+    }
+}
+/**
+ * Stop the price oracle polling loop.
+ */
+export function stopPriceOracle() {
+    if (pollTimer) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+        logger.info('Price oracle stopped');
+    }
+}
+/**
+ * Check if the price oracle is currently running.
+ */
+export function isPriceOracleRunning() {
+    return pollTimer !== null;
+}
+//# sourceMappingURL=oracle.js.map

package/dist/revealcoin/oracle.js.map

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