@wopr-network/platform-core 1.66.1 → 1.67.1

package/dist/billing/crypto/oracle/__tests__/chainlink.test.js

@@ -1,83 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { ChainlinkOracle } from "../chainlink.js";
-/**
- * Encode a mock latestRoundData() response.
- * Chainlink returns 5 × 32-byte ABI-encoded words:
- *   roundId, answer, startedAt, updatedAt, answeredInRound
- */
-function encodeRoundData(answer, updatedAtSec) {
-    const pad = (v) => v.toString(16).padStart(64, "0");
-    return ("0x" +
-        pad(1n) + // roundId
-        pad(answer) + // answer (price × 10^8)
-        pad(BigInt(updatedAtSec)) + // startedAt
-        pad(BigInt(updatedAtSec)) + // updatedAt
-        pad(1n) // answeredInRound
-    );
-}
-describe("ChainlinkOracle", () => {
-    const nowSec = Math.floor(Date.now() / 1000);
-    it("decodes ETH/USD price from latestRoundData", async () => {
-        // ETH at $3,500.00 → answer = 3500 × 10^8 = 350_000_000_000
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(350000000000n, nowSec));
-        const oracle = new ChainlinkOracle({ rpcCall: rpc });
-        const result = await oracle.getPrice("ETH");
-        expect(result.priceMicros).toBe(3_500_000_000); // $3,500.00
-        expect(result.updatedAt).toBeInstanceOf(Date);
-        expect(rpc).toHaveBeenCalledWith("eth_call", [
-            { to: "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70", data: "0xfeaf968c" },
-            "latest",
-        ]);
-    });
-    it("decodes BTC/USD price from latestRoundData", async () => {
-        // BTC at $65,000.00 → answer = 65000 × 10^8 = 6_500_000_000_000
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(6500000000000n, nowSec));
-        const oracle = new ChainlinkOracle({ rpcCall: rpc });
-        const result = await oracle.getPrice("BTC");
-        expect(result.priceMicros).toBe(65_000_000_000); // $65,000.00
-    });
-    it("handles fractional dollar prices correctly", async () => {
-        // ETH at $3,456.78 → answer = 345_678_000_000
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(345678000000n, nowSec));
-        const oracle = new ChainlinkOracle({ rpcCall: rpc });
-        const result = await oracle.getPrice("ETH");
-        expect(result.priceMicros).toBe(3_456_780_000); // $3,456.78
-    });
-    it("rejects stale prices", async () => {
-        const staleTime = nowSec - 7200; // 2 hours ago
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(350000000000n, staleTime));
-        const oracle = new ChainlinkOracle({ rpcCall: rpc, maxStalenessMs: 3600_000 });
-        await expect(oracle.getPrice("ETH")).rejects.toThrow("stale");
-    });
-    it("rejects zero price", async () => {
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(0n, nowSec));
-        const oracle = new ChainlinkOracle({ rpcCall: rpc });
-        await expect(oracle.getPrice("ETH")).rejects.toThrow("Invalid price");
-    });
-    it("rejects malformed response", async () => {
-        const rpc = vi.fn().mockResolvedValue("0xdead");
-        const oracle = new ChainlinkOracle({ rpcCall: rpc });
-        await expect(oracle.getPrice("ETH")).rejects.toThrow("Malformed");
-    });
-    it("accepts custom feed addresses", async () => {
-        const customFeed = "0x1234567890abcdef1234567890abcdef12345678";
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(350000000000n, nowSec));
-        const oracle = new ChainlinkOracle({
-            rpcCall: rpc,
-            feedAddresses: { ETH: customFeed },
-        });
-        await oracle.getPrice("ETH");
-        expect(rpc).toHaveBeenCalledWith("eth_call", [{ to: customFeed, data: "0xfeaf968c" }, "latest"]);
-    });
-    it("respects custom staleness threshold", async () => {
-        const thirtyMinAgo = nowSec - 1800;
-        const rpc = vi.fn().mockResolvedValue(encodeRoundData(350000000000n, thirtyMinAgo));
-        // 20-minute threshold → stale
-        const strict = new ChainlinkOracle({ rpcCall: rpc, maxStalenessMs: 20 * 60 * 1000 });
-        await expect(strict.getPrice("ETH")).rejects.toThrow("stale");
-        // 60-minute threshold → fresh
-        const relaxed = new ChainlinkOracle({ rpcCall: rpc, maxStalenessMs: 60 * 60 * 1000 });
-        const result = await relaxed.getPrice("ETH");
-        expect(result.priceMicros).toBe(3_500_000_000);
-    });
-});

package/dist/billing/crypto/oracle/__tests__/coingecko.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/billing/crypto/oracle/__tests__/coingecko.test.js

@@ -1,65 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { CoinGeckoOracle } from "../coingecko.js";
-describe("CoinGeckoOracle", () => {
-    const mockFetch = (price) => vi.fn().mockResolvedValue({
-        ok: true,
-        json: () => Promise.resolve({ bitcoin: { usd: price } }),
-    });
-    it("returns price in microdollars from CoinGecko API", async () => {
-        const oracle = new CoinGeckoOracle({ fetchFn: mockFetch(84_532.17) });
-        const result = await oracle.getPrice("BTC");
-        expect(result.priceMicros).toBe(84_532_170_000);
-        expect(result.updatedAt).toBeInstanceOf(Date);
-    });
-    it("caches prices within TTL", async () => {
-        const fn = mockFetch(84_532.17);
-        const oracle = new CoinGeckoOracle({ fetchFn: fn, cacheTtlMs: 60_000 });
-        await oracle.getPrice("BTC");
-        await oracle.getPrice("BTC");
-        expect(fn).toHaveBeenCalledTimes(1);
-    });
-    it("re-fetches after cache expires", async () => {
-        const fn = mockFetch(84_532.17);
-        const oracle = new CoinGeckoOracle({ fetchFn: fn, cacheTtlMs: 0 });
-        await oracle.getPrice("BTC");
-        await oracle.getPrice("BTC");
-        expect(fn).toHaveBeenCalledTimes(2);
-    });
-    it("throws for unknown asset", async () => {
-        const oracle = new CoinGeckoOracle({ fetchFn: mockFetch(100) });
-        await expect(oracle.getPrice("UNKNOWN")).rejects.toThrow("No price oracle supports asset: UNKNOWN");
-    });
-    it("throws on API error", async () => {
-        const fn = vi.fn().mockResolvedValue({ ok: false, status: 429, statusText: "Too Many Requests" });
-        const oracle = new CoinGeckoOracle({ fetchFn: fn });
-        await expect(oracle.getPrice("BTC")).rejects.toThrow("CoinGecko API error");
-    });
-    it("throws on zero price", async () => {
-        const fn = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ bitcoin: { usd: 0 } }),
-        });
-        const oracle = new CoinGeckoOracle({ fetchFn: fn });
-        await expect(oracle.getPrice("BTC")).rejects.toThrow("Invalid CoinGecko price");
-    });
-    it("resolves DOGE via coingecko ID mapping", async () => {
-        const fn = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ dogecoin: { usd: 0.1742 } }),
-        });
-        const oracle = new CoinGeckoOracle({ fetchFn: fn });
-        const result = await oracle.getPrice("DOGE");
-        expect(result.priceMicros).toBe(174_200);
-        expect(fn).toHaveBeenCalledWith(expect.stringContaining("ids=dogecoin"));
-    });
-    it("resolves LTC via coingecko ID mapping", async () => {
-        const fn = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ litecoin: { usd: 92.45 } }),
-        });
-        const oracle = new CoinGeckoOracle({ fetchFn: fn });
-        const result = await oracle.getPrice("LTC");
-        expect(result.priceMicros).toBe(92_450_000);
-        expect(fn).toHaveBeenCalledWith(expect.stringContaining("ids=litecoin"));
-    });
-});

package/dist/billing/crypto/oracle/__tests__/composite.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/billing/crypto/oracle/__tests__/composite.test.js

@@ -1,48 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { CompositeOracle } from "../composite.js";
-function mockOracle(priceMicros) {
-    return { getPrice: vi.fn().mockResolvedValue({ priceMicros, updatedAt: new Date() }) };
-}
-function failingOracle(msg = "no feed") {
-    return { getPrice: vi.fn().mockRejectedValue(new Error(msg)) };
-}
-describe("CompositeOracle", () => {
-    it("uses primary when feedAddress is provided and primary succeeds", async () => {
-        const primary = mockOracle(8_500_000);
-        const fallback = mockOracle(8_400_000);
-        const oracle = new CompositeOracle(primary, fallback);
-        const result = await oracle.getPrice("BTC", "0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F");
-        expect(result.priceMicros).toBe(8_500_000);
-        expect(primary.getPrice).toHaveBeenCalledWith("BTC", "0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F");
-        expect(fallback.getPrice).not.toHaveBeenCalled();
-    });
-    it("falls back when primary fails with feedAddress", async () => {
-        const primary = failingOracle("stale");
-        const fallback = mockOracle(8_400_000);
-        const oracle = new CompositeOracle(primary, fallback);
-        const result = await oracle.getPrice("BTC", "0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F");
-        expect(result.priceMicros).toBe(8_400_000);
-    });
-    it("tries primary without feed, then falls back for unknown assets", async () => {
-        const primary = failingOracle("No price feed for asset: DOGE");
-        const fallback = mockOracle(17);
-        const oracle = new CompositeOracle(primary, fallback);
-        const result = await oracle.getPrice("DOGE");
-        expect(result.priceMicros).toBe(17);
-    });
-    it("uses primary built-in feeds for BTC/ETH without explicit feedAddress", async () => {
-        const primary = mockOracle(8_500_000);
-        const fallback = mockOracle(8_400_000);
-        const oracle = new CompositeOracle(primary, fallback);
-        const result = await oracle.getPrice("BTC");
-        expect(result.priceMicros).toBe(8_500_000);
-        expect(primary.getPrice).toHaveBeenCalledWith("BTC");
-        expect(fallback.getPrice).not.toHaveBeenCalled();
-    });
-    it("propagates fallback errors when both fail", async () => {
-        const primary = failingOracle("no chainlink");
-        const fallback = failingOracle("no coingecko");
-        const oracle = new CompositeOracle(primary, fallback);
-        await expect(oracle.getPrice("UNKNOWN")).rejects.toThrow("no coingecko");
-    });
-});

package/dist/billing/crypto/oracle/__tests__/convert.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/billing/crypto/oracle/__tests__/convert.test.js

@@ -1,61 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { centsToNative, nativeToCents } from "../convert.js";
-describe("centsToNative", () => {
-    it("converts $50 to ETH wei at $3,500", () => {
-        // 5000 cents × 10000 × 10^18 / 3_500_000_000 micros = 14285714285714285n wei
-        const wei = centsToNative(5000, 3_500_000_000, 18);
-        expect(wei).toBe(14285714285714285n);
-    });
-    it("converts $50 to BTC sats at $65,000", () => {
-        // 5000 cents × 10000 × 10^8 / 65_000_000_000 micros = 76923n sats
-        const sats = centsToNative(5000, 65_000_000_000, 8);
-        expect(sats).toBe(76923n);
-    });
-    it("converts $50 to DOGE at $0.094147", () => {
-        // 5000 cents × 10000 × 10^8 / 94_147 micros = 53_107_898_982n base units (531.08 DOGE)
-        const dogeUnits = centsToNative(5000, 94_147, 8);
-        expect(Number(dogeUnits) / 1e8).toBeCloseTo(531.08, 0);
-    });
-    it("converts $50 to LTC at $55.79", () => {
-        // 5000 cents × 10000 × 10^8 / 55_790_000 micros = 89_622_512n base units (0.896 LTC)
-        const ltcUnits = centsToNative(5000, 55_790_000, 8);
-        expect(Number(ltcUnits) / 1e8).toBeCloseTo(0.896, 2);
-    });
-    it("converts $100 to ETH wei at $2,000", () => {
-        // 10000 cents × 10000 × 10^18 / 2_000_000_000 micros = 50_000_000_000_000_000n (0.05 ETH)
-        const wei = centsToNative(10_000, 2_000_000_000, 18);
-        expect(wei).toBe(50000000000000000n);
-    });
-    it("rejects non-integer amountCents", () => {
-        expect(() => centsToNative(50.5, 3_500_000_000, 18)).toThrow("positive integer");
-    });
-    it("rejects zero amountCents", () => {
-        expect(() => centsToNative(0, 3_500_000_000, 18)).toThrow("positive integer");
-    });
-    it("rejects zero priceMicros", () => {
-        expect(() => centsToNative(5000, 0, 18)).toThrow("positive integer");
-    });
-    it("rejects negative decimals", () => {
-        expect(() => centsToNative(5000, 3_500_000_000, -1)).toThrow("non-negative integer");
-    });
-});
-describe("nativeToCents", () => {
-    it("converts ETH wei back to cents at $3,500", () => {
-        // 14285714285714285n × 3_500_000_000 / (10000 × 10^18) = 4999 cents (truncated)
-        const cents = nativeToCents(14285714285714285n, 3_500_000_000, 18);
-        expect(cents).toBe(4999);
-    });
-    it("converts BTC sats back to cents at $65,000", () => {
-        // 76923n × 65_000_000_000 / (10000 × 10^8) = 4999 cents
-        const cents = nativeToCents(76923n, 65_000_000_000, 8);
-        expect(cents).toBe(4999);
-    });
-    it("exact round-trip for clean division", () => {
-        // 0.05 ETH at $2,000 = $100
-        const cents = nativeToCents(50000000000000000n, 2_000_000_000, 18);
-        expect(cents).toBe(10_000); // $100.00
-    });
-    it("rejects negative rawAmount", () => {
-        expect(() => nativeToCents(-1n, 3_500_000_000, 18)).toThrow("non-negative");
-    });
-});

package/dist/billing/crypto/oracle/__tests__/fixed.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/billing/crypto/oracle/__tests__/fixed.test.js

@@ -1,20 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { FixedPriceOracle } from "../fixed.js";
-describe("FixedPriceOracle", () => {
-    it("returns default ETH price", async () => {
-        const oracle = new FixedPriceOracle();
-        const result = await oracle.getPrice("ETH");
-        expect(result.priceMicros).toBe(3_500_000_000); // $3,500
-        expect(result.updatedAt).toBeInstanceOf(Date);
-    });
-    it("returns default BTC price", async () => {
-        const oracle = new FixedPriceOracle();
-        const result = await oracle.getPrice("BTC");
-        expect(result.priceMicros).toBe(65_000_000_000); // $65,000
-    });
-    it("accepts custom prices", async () => {
-        const oracle = new FixedPriceOracle({ ETH: 2_000_000_000, BTC: 50_000_000_000 });
-        expect((await oracle.getPrice("ETH")).priceMicros).toBe(2_000_000_000);
-        expect((await oracle.getPrice("BTC")).priceMicros).toBe(50_000_000_000);
-    });
-});

package/dist/billing/crypto/oracle/chainlink.d.ts

@@ -1,26 +0,0 @@
-import type { IPriceOracle, PriceAsset, PriceResult } from "./types.js";
-type RpcCall = (method: string, params: unknown[]) => Promise<unknown>;
-export interface ChainlinkOracleOpts {
-    rpcCall: RpcCall;
-    /** Override feed addresses (e.g. for testnet or Anvil forks). */
-    feedAddresses?: Partial<Record<PriceAsset, `0x${string}`>>;
-    /** Maximum age of price data before rejecting (ms). Default: 1 hour. */
-    maxStalenessMs?: number;
-}
-/**
- * On-chain Chainlink price oracle.
- *
- * Reads latestRoundData() from Chainlink aggregator contracts via eth_call.
- * No API key, no rate limits — just an RPC call to our own node.
- *
- * Chainlink USD feeds use 8 decimals. We convert to integer USD cents:
- *   priceMicros = answer / 100  (i.e. answer / 10^8 * 10^6)
- */
-export declare class ChainlinkOracle implements IPriceOracle {
-    private readonly rpc;
-    private readonly feeds;
-    private readonly maxStalenessMs;
-    constructor(opts: ChainlinkOracleOpts);
-    getPrice(asset: PriceAsset, feedAddress?: `0x${string}`): Promise<PriceResult>;
-}
-export {};

package/dist/billing/crypto/oracle/chainlink.js

@@ -1,62 +0,0 @@
-/**
- * Chainlink price feed addresses on Base mainnet.
- * These are ERC-1967 proxy contracts — addresses are stable.
- */
-const FEED_ADDRESSES = {
-    ETH: "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70",
-    BTC: "0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F",
-};
-/** Function selector for latestRoundData(). */
-const LATEST_ROUND_DATA = "0xfeaf968c";
-/** Default max staleness: 1 hour. */
-const DEFAULT_MAX_STALENESS_MS = 60 * 60 * 1000;
-/**
- * On-chain Chainlink price oracle.
- *
- * Reads latestRoundData() from Chainlink aggregator contracts via eth_call.
- * No API key, no rate limits — just an RPC call to our own node.
- *
- * Chainlink USD feeds use 8 decimals. We convert to integer USD cents:
- *   priceMicros = answer / 100  (i.e. answer / 10^8 * 10^6)
- */
-export class ChainlinkOracle {
-    rpc;
-    feeds;
-    maxStalenessMs;
-    constructor(opts) {
-        this.rpc = opts.rpcCall;
-        this.feeds = new Map(Object.entries({ ...FEED_ADDRESSES, ...opts.feedAddresses }));
-        this.maxStalenessMs = opts.maxStalenessMs ?? DEFAULT_MAX_STALENESS_MS;
-    }
-    async getPrice(asset, feedAddress) {
-        const resolvedFeed = feedAddress ?? this.feeds.get(asset);
-        if (!resolvedFeed)
-            throw new Error(`No price feed for asset: ${asset}`);
-        const result = (await this.rpc("eth_call", [{ to: resolvedFeed, data: LATEST_ROUND_DATA }, "latest"]));
-        // ABI decode latestRoundData() return:
-        //   [0]  roundId       (uint80)  — skip
-        //   [1]  answer        (int256)  — price × 10^8
-        //   [2]  startedAt     (uint256) — skip
-        //   [3]  updatedAt     (uint256) — unix seconds
-        //   [4]  answeredInRound (uint80) — skip
-        const hex = result.slice(2);
-        if (hex.length < 320) {
-            throw new Error(`Malformed Chainlink response for ${asset}: expected 320 hex chars, got ${hex.length}`);
-        }
-        const answer = BigInt(`0x${hex.slice(64, 128)}`);
-        const updatedAtSec = Number(BigInt(`0x${hex.slice(192, 256)}`));
-        const updatedAt = new Date(updatedAtSec * 1000);
-        // Staleness guard.
-        const ageMs = Date.now() - updatedAt.getTime();
-        if (ageMs > this.maxStalenessMs) {
-            throw new Error(`Price feed for ${asset} is stale (${Math.round(ageMs / 1000)}s old, max ${Math.round(this.maxStalenessMs / 1000)}s)`);
-        }
-        // Chainlink USD feeds: 8 decimals. answer / 100 = microdollars (10^-6 USD).
-        // e.g. BTC at $70,315 → answer = 7_031_500_000_000 → 70_315_000_000 microdollars
-        const priceMicros = Number(answer / 100n);
-        if (priceMicros <= 0) {
-            throw new Error(`Invalid price for ${asset}: ${priceMicros} microdollars`);
-        }
-        return { priceMicros, updatedAt };
-    }
-}

package/dist/billing/crypto/oracle/coingecko.d.ts

@@ -1,22 +0,0 @@
-import type { IPriceOracle, PriceAsset, PriceResult } from "./types.js";
-export interface CoinGeckoOracleOpts {
-    /** Override token→id mapping. */
-    tokenIds?: Record<string, string>;
-    /** Cache TTL in ms. Default: 60s. */
-    cacheTtlMs?: number;
-    /** Custom fetch function (for testing). */
-    fetchFn?: typeof fetch;
-}
-/**
- * CoinGecko price oracle — free API, no key required.
- * Used for assets without Chainlink on-chain feeds (DOGE, LTC).
- * Caches prices to stay within rate limits.
- */
-export declare class CoinGeckoOracle implements IPriceOracle {
-    private readonly ids;
-    private readonly cacheTtlMs;
-    private readonly fetchFn;
-    private readonly cache;
-    constructor(opts?: CoinGeckoOracleOpts);
-    getPrice(asset: PriceAsset, _feedAddress?: `0x${string}`): Promise<PriceResult>;
-}

package/dist/billing/crypto/oracle/coingecko.js

@@ -1,71 +0,0 @@
-import { AssetNotSupportedError } from "./types.js";
-/**
- * Token symbol → CoinGecko API ID mapping.
- * CoinGecko uses lowercase slugs, not ticker symbols.
- */
-const COINGECKO_IDS = {
-    BTC: "bitcoin",
-    ETH: "ethereum",
-    DOGE: "dogecoin",
-    LTC: "litecoin",
-    SOL: "solana",
-    LINK: "chainlink",
-    UNI: "uniswap",
-    AERO: "aerodrome-finance",
-    TRX: "tron",
-    BNB: "binancecoin",
-    POL: "matic-network",
-    AVAX: "avalanche-2",
-};
-/** Default cache TTL: 60 seconds. CoinGecko free tier allows 10-30 req/min. */
-const DEFAULT_CACHE_TTL_MS = 60_000;
-/**
- * CoinGecko price oracle — free API, no key required.
- * Used for assets without Chainlink on-chain feeds (DOGE, LTC).
- * Caches prices to stay within rate limits.
- */
-export class CoinGeckoOracle {
-    ids;
-    cacheTtlMs;
-    fetchFn;
-    cache = new Map();
-    constructor(opts = {}) {
-        this.ids = { ...COINGECKO_IDS, ...opts.tokenIds };
-        this.cacheTtlMs = opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
-        this.fetchFn = opts.fetchFn ?? fetch;
-    }
-    async getPrice(asset, _feedAddress) {
-        const cached = this.cache.get(asset);
-        if (cached && Date.now() - cached.fetchedAt < this.cacheTtlMs) {
-            return { priceMicros: cached.priceMicros, updatedAt: cached.updatedAt };
-        }
-        const coinId = this.ids[asset];
-        if (!coinId)
-            throw new AssetNotSupportedError(asset);
-        const url = `https://api.coingecko.com/api/v3/simple/price?ids=${coinId}&vs_currencies=usd`;
-        try {
-            const res = await this.fetchFn(url);
-            if (!res.ok) {
-                throw new Error(`CoinGecko API error for ${asset}: ${res.status} ${res.statusText}`);
-            }
-            const data = (await res.json());
-            const usdPrice = data[coinId]?.usd;
-            if (usdPrice === undefined || usdPrice <= 0) {
-                throw new Error(`Invalid CoinGecko price for ${asset}: ${usdPrice}`);
-            }
-            const priceMicros = Math.round(usdPrice * 1_000_000);
-            const updatedAt = new Date();
-            this.cache.set(asset, { priceMicros, updatedAt, fetchedAt: Date.now() });
-            return { priceMicros, updatedAt };
-        }
-        catch (err) {
-            // Serve stale cache on transient failure (rate limit, network error).
-            // A slightly old price is better than rejecting the charge entirely.
-            const stale = this.cache.get(asset);
-            if (stale) {
-                return { priceMicros: stale.priceMicros, updatedAt: stale.updatedAt };
-            }
-            throw err;
-        }
-    }
-}

package/dist/billing/crypto/oracle/composite.d.ts

@@ -1,14 +0,0 @@
-import type { IPriceOracle, PriceAsset, PriceResult } from "./types.js";
-/**
- * Composite oracle — tries primary (Chainlink on-chain), falls back to secondary (CoinGecko).
- *
- * When a feedAddress is provided (from payment_methods.oracle_address), the primary
- * oracle is used with that address. When no feed exists or the primary fails,
- * the fallback oracle is consulted.
- */
-export declare class CompositeOracle implements IPriceOracle {
-    private readonly primary;
-    private readonly fallback;
-    constructor(primary: IPriceOracle, fallback: IPriceOracle);
-    getPrice(asset: PriceAsset, feedAddress?: `0x${string}`): Promise<PriceResult>;
-}

package/dist/billing/crypto/oracle/composite.js

@@ -1,34 +0,0 @@
-/**
- * Composite oracle — tries primary (Chainlink on-chain), falls back to secondary (CoinGecko).
- *
- * When a feedAddress is provided (from payment_methods.oracle_address), the primary
- * oracle is used with that address. When no feed exists or the primary fails,
- * the fallback oracle is consulted.
- */
-export class CompositeOracle {
-    primary;
-    fallback;
-    constructor(primary, fallback) {
-        this.primary = primary;
-        this.fallback = fallback;
-    }
-    async getPrice(asset, feedAddress) {
-        // If a specific feed address is provided, try the primary (Chainlink) first
-        if (feedAddress) {
-            try {
-                return await this.primary.getPrice(asset, feedAddress);
-            }
-            catch {
-                // Primary failed (stale, network error) — fall through to fallback
-            }
-        }
-        // Try primary without explicit feed (uses built-in feed map for BTC/ETH)
-        try {
-            return await this.primary.getPrice(asset);
-        }
-        catch {
-            // No feed configured or call failed — use fallback
-        }
-        return this.fallback.getPrice(asset);
-    }
-}

package/dist/billing/crypto/oracle/convert.d.ts

@@ -1,30 +0,0 @@
-/**
- * Price units: **microdollars** (1 microdollar = $0.000001 = 10^-6 USD).
- *
- * Why not cents? DOGE at $0.094 rounds to 9 cents — 6% error.
- * Microdollars give 6 decimal places: $0.094147 = 94,147 microdollars.
- *
- * Chainlink feeds: 8 decimals → answer / 100 = microdollars.
- * CoinGecko: Math.round(usd * 1_000_000) = microdollars.
- * All math is integer bigint — no floating point.
- */
-/**
- * Convert USD cents to native token amount using a price in microdollars.
- *
- * Formula: rawAmount = (amountCents × 10_000) × 10^decimals / priceMicros
- *
- * Examples:
- *   $50 in BTC at $70,315:  centsToNative(5000, 70_315_000_000, 8) = 71,119 sats
- *   $50 in DOGE at $0.094:  centsToNative(5000, 94_147, 8) = 53,107,898,982 base units (531.08 DOGE)
- *
- * Integer math only. No floating point.
- */
-export declare function centsToNative(amountCents: number, priceMicros: number, decimals: number): bigint;
-/**
- * Convert native token amount back to USD cents using a price in microdollars.
- *
- * Inverse of centsToNative. Truncates fractional cents.
- *
- * Integer math only.
- */
-export declare function nativeToCents(rawAmount: bigint, priceMicros: number, decimals: number): number;

package/dist/billing/crypto/oracle/convert.js

@@ -1,51 +0,0 @@
-/**
- * Price units: **microdollars** (1 microdollar = $0.000001 = 10^-6 USD).
- *
- * Why not cents? DOGE at $0.094 rounds to 9 cents — 6% error.
- * Microdollars give 6 decimal places: $0.094147 = 94,147 microdollars.
- *
- * Chainlink feeds: 8 decimals → answer / 100 = microdollars.
- * CoinGecko: Math.round(usd * 1_000_000) = microdollars.
- * All math is integer bigint — no floating point.
- */
-/** Microdollars per cent. Multiply amountCents by this to get microdollars. */
-const MICROS_PER_CENT = 10000n;
-/**
- * Convert USD cents to native token amount using a price in microdollars.
- *
- * Formula: rawAmount = (amountCents × 10_000) × 10^decimals / priceMicros
- *
- * Examples:
- *   $50 in BTC at $70,315:  centsToNative(5000, 70_315_000_000, 8) = 71,119 sats
- *   $50 in DOGE at $0.094:  centsToNative(5000, 94_147, 8) = 53,107,898,982 base units (531.08 DOGE)
- *
- * Integer math only. No floating point.
- */
-export function centsToNative(amountCents, priceMicros, decimals) {
-    if (!Number.isInteger(amountCents) || amountCents <= 0) {
-        throw new Error(`amountCents must be a positive integer, got ${amountCents}`);
-    }
-    if (!Number.isInteger(priceMicros) || priceMicros <= 0) {
-        throw new Error(`priceMicros must be a positive integer, got ${priceMicros}`);
-    }
-    if (!Number.isInteger(decimals) || decimals < 0) {
-        throw new Error(`decimals must be a non-negative integer, got ${decimals}`);
-    }
-    // Convert amountCents to microdollars to match priceMicros units
-    return (BigInt(amountCents) * MICROS_PER_CENT * 10n ** BigInt(decimals)) / BigInt(priceMicros);
-}
-/**
- * Convert native token amount back to USD cents using a price in microdollars.
- *
- * Inverse of centsToNative. Truncates fractional cents.
- *
- * Integer math only.
- */
-export function nativeToCents(rawAmount, priceMicros, decimals) {
-    if (rawAmount < 0n)
-        throw new Error("rawAmount must be non-negative");
-    if (!Number.isInteger(priceMicros) || priceMicros <= 0) {
-        throw new Error(`priceMicros must be a positive integer, got ${priceMicros}`);
-    }
-    return Number((rawAmount * BigInt(priceMicros)) / (MICROS_PER_CENT * 10n ** BigInt(decimals)));
-}

package/dist/billing/crypto/oracle/fixed.d.ts

@@ -1,10 +0,0 @@
-import type { IPriceOracle, PriceAsset, PriceResult } from "./types.js";
-/**
- * Fixed-price oracle for testing and local dev (Anvil, regtest).
- * Returns hardcoded prices in microdollars — no RPC calls.
- */
-export declare class FixedPriceOracle implements IPriceOracle {
-    private readonly prices;
-    constructor(prices?: Partial<Record<PriceAsset, number>>);
-    getPrice(asset: PriceAsset, _feedAddress?: `0x${string}`): Promise<PriceResult>;
-}

package/dist/billing/crypto/oracle/fixed.js

@@ -1,22 +0,0 @@
-/**
- * Fixed-price oracle for testing and local dev (Anvil, regtest).
- * Returns hardcoded prices in microdollars — no RPC calls.
- */
-export class FixedPriceOracle {
-    prices;
-    constructor(prices = {}) {
-        this.prices = {
-            ETH: 3_500_000_000, // $3,500 in microdollars
-            BTC: 65_000_000_000, // $65,000 in microdollars
-            DOGE: 94_000, // $0.094 in microdollars
-            LTC: 55_000_000, // $55 in microdollars
-            ...prices,
-        };
-    }
-    async getPrice(asset, _feedAddress) {
-        const priceMicros = this.prices[asset];
-        if (priceMicros === undefined)
-            throw new Error(`No fixed price for ${asset}`);
-        return { priceMicros, updatedAt: new Date() };
-    }
-}

package/dist/billing/crypto/oracle/index.d.ts

@@ -1,9 +0,0 @@
-export type { ChainlinkOracleOpts } from "./chainlink.js";
-export { ChainlinkOracle } from "./chainlink.js";
-export type { CoinGeckoOracleOpts } from "./coingecko.js";
-export { CoinGeckoOracle } from "./coingecko.js";
-export { CompositeOracle } from "./composite.js";
-export { centsToNative, nativeToCents } from "./convert.js";
-export { FixedPriceOracle } from "./fixed.js";
-export type { IPriceOracle, PriceAsset, PriceResult } from "./types.js";
-export { AssetNotSupportedError } from "./types.js";