@wopr-network/platform-core 1.66.1 → 1.67.1

package/dist/billing/crypto/evm/__tests__/watcher-confirmations.test.js

@@ -1,159 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { EvmWatcher } from "../watcher.js";
-const TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
-function mockTransferLog(to, amount, blockNumber) {
-    return {
-        address: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
-        topics: [
-            TRANSFER_TOPIC,
-            `0x${"00".repeat(12)}${"ab".repeat(20)}`,
-            `0x${"00".repeat(12)}${to.slice(2).toLowerCase()}`,
-        ],
-        data: `0x${amount.toString(16).padStart(64, "0")}`,
-        blockNumber: `0x${blockNumber.toString(16)}`,
-        transactionHash: `0x${"ff".repeat(32)}`,
-        logIndex: "0x0",
-    };
-}
-function makeCursorStore() {
-    const cursors = new Map();
-    return {
-        get: vi.fn().mockImplementation(async (id) => cursors.get(id) ?? null),
-        save: vi.fn().mockImplementation(async (id, val) => {
-            cursors.set(id, val);
-        }),
-        hasProcessedTx: vi.fn().mockResolvedValue(false),
-        markProcessedTx: vi.fn().mockResolvedValue(undefined),
-        getConfirmationCount: vi.fn().mockResolvedValue(null),
-        saveConfirmationCount: vi.fn().mockResolvedValue(undefined),
-    };
-}
-describe("EvmWatcher — intermediate confirmations", () => {
-    it("emits events with confirmation count", async () => {
-        const toAddr = `0x${"cc".repeat(20)}`;
-        const events = [];
-        // Base has confirmations: 1. Latest block is 105. Log at block 103 -> 2 confirmations.
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(105).toString(16)}`) // eth_blockNumber
-            .mockResolvedValueOnce([mockTransferLog(toAddr, 10000000n, 103)]); // eth_getLogs
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: [toAddr],
-            cursorStore: makeCursorStore(),
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(1);
-        expect(events[0].confirmations).toBe(2); // 105 - 103
-        expect(events[0].confirmationsRequired).toBe(1); // Base chain config
-    });
-    it("skips event when confirmation count unchanged", async () => {
-        const toAddr = `0x${"cc".repeat(20)}`;
-        const events = [];
-        const cursorStore = makeCursorStore();
-        cursorStore.getConfirmationCount.mockResolvedValue(2);
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(105).toString(16)}`)
-            .mockResolvedValueOnce([mockTransferLog(toAddr, 10000000n, 103)]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: [toAddr],
-            cursorStore,
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(0);
-    });
-    it("re-emits when confirmations increase", async () => {
-        const toAddr = `0x${"cc".repeat(20)}`;
-        const events = [];
-        const cursorStore = makeCursorStore();
-        cursorStore.getConfirmationCount.mockResolvedValue(1);
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(105).toString(16)}`)
-            .mockResolvedValueOnce([mockTransferLog(toAddr, 10000000n, 103)]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: [toAddr],
-            cursorStore,
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(1);
-        expect(events[0].confirmations).toBe(2);
-    });
-    it("includes confirmationsRequired from chain config", async () => {
-        const toAddr = `0x${"cc".repeat(20)}`;
-        const events = [];
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(110).toString(16)}`)
-            .mockResolvedValueOnce([mockTransferLog(toAddr, 10000000n, 105)]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: [toAddr],
-            cursorStore: makeCursorStore(),
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(1);
-        expect(events[0].confirmationsRequired).toBe(1); // Base chain config
-    });
-    it("saves confirmation count after emitting", async () => {
-        const toAddr = `0x${"cc".repeat(20)}`;
-        const cursorStore = makeCursorStore();
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(105).toString(16)}`)
-            .mockResolvedValueOnce([mockTransferLog(toAddr, 10000000n, 103)]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: [toAddr],
-            cursorStore,
-            onPayment: () => { },
-        });
-        await watcher.poll();
-        expect(cursorStore.saveConfirmationCount).toHaveBeenCalledWith(expect.any(String), expect.stringContaining("0x"), 2);
-    });
-});

package/dist/billing/crypto/evm/__tests__/watcher.test.d.ts

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

package/dist/billing/crypto/evm/__tests__/watcher.test.js

@@ -1,145 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { EvmWatcher } from "../watcher.js";
-const TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
-function mockTransferLog(to, amount, blockNumber) {
-    return {
-        address: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
-        topics: [
-            TRANSFER_TOPIC,
-            `0x${"00".repeat(12)}${"ab".repeat(20)}`, // from (padded)
-            `0x${"00".repeat(12)}${to.slice(2).toLowerCase()}`, // to (padded)
-        ],
-        data: `0x${amount.toString(16).padStart(64, "0")}`,
-        blockNumber: `0x${blockNumber.toString(16)}`,
-        transactionHash: `0x${"ff".repeat(32)}`,
-        logIndex: "0x0",
-    };
-}
-describe("EvmWatcher", () => {
-    it("parses Transfer log into EvmPaymentEvent", async () => {
-        const toAddr = `0x${"cc".repeat(20)}`;
-        const events = [];
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(102).toString(16)}`)
-            .mockResolvedValueOnce([mockTransferLog(toAddr, 10000000n, 99)]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 99,
-            watchedAddresses: [toAddr],
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(1);
-        expect(events[0].amountUsdCents).toBe(1000);
-        expect(events[0].to).toMatch(/^0x/);
-    });
-    it("advances cursor after processing", async () => {
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(200).toString(16)}`)
-            .mockResolvedValueOnce([]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: ["0xdeadbeef"],
-            onPayment: vi.fn(),
-        });
-        await watcher.poll();
-        expect(watcher.cursor).toBeGreaterThan(100);
-    });
-    it("skips blocks not yet confirmed", async () => {
-        const events = [];
-        // latest = 50, cursor = 50 → latest < cursor is false, but range is empty (50..50)
-        // With intermediate confirmations, we still scan the range but find no logs
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(50).toString(16)}`) // eth_blockNumber
-            .mockResolvedValueOnce([]); // eth_getLogs (empty)
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 50,
-            watchedAddresses: ["0xdeadbeef"],
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(0);
-    });
-    it("processes multiple logs in one poll", async () => {
-        const addr1 = `0x${"aa".repeat(20)}`;
-        const addr2 = `0x${"bb".repeat(20)}`;
-        const events = [];
-        const mockRpc = vi
-            .fn()
-            .mockResolvedValueOnce(`0x${(110).toString(16)}`)
-            .mockResolvedValueOnce([mockTransferLog(addr1, 5000000n, 105), mockTransferLog(addr2, 20000000n, 107)]);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: [addr1, addr2],
-            onPayment: (evt) => {
-                events.push(evt);
-            },
-        });
-        await watcher.poll();
-        expect(events).toHaveLength(2);
-        expect(events[0].amountUsdCents).toBe(500);
-        expect(events[1].amountUsdCents).toBe(2000);
-    });
-    it("does nothing when no new blocks", async () => {
-        const mockRpc = vi.fn().mockResolvedValueOnce(`0x${(99).toString(16)}`);
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 100,
-            watchedAddresses: ["0xdeadbeef"],
-            onPayment: vi.fn(),
-        });
-        await watcher.poll();
-        expect(watcher.cursor).toBe(100);
-        expect(mockRpc).toHaveBeenCalledTimes(1);
-    });
-    it("early-returns when no watched addresses are set", async () => {
-        const mockRpc = vi.fn();
-        const watcher = new EvmWatcher({
-            chain: "base",
-            token: "USDC",
-            contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-            decimals: 6,
-            confirmations: 1,
-            rpcCall: mockRpc,
-            fromBlock: 0,
-            onPayment: vi.fn(),
-        });
-        await watcher.poll();
-        expect(mockRpc).not.toHaveBeenCalled(); // no RPC calls at all
-    });
-});

package/dist/billing/crypto/evm/eth-watcher.d.ts

@@ -1,66 +0,0 @@
-import type { IWatcherCursorStore } from "../cursor-store.js";
-import type { IPriceOracle } from "../oracle/types.js";
-import type { EvmChain } from "./types.js";
-type RpcCall = (method: string, params: unknown[]) => Promise<unknown>;
-/** Event emitted on each confirmation increment for a native ETH deposit. */
-export interface EthPaymentEvent {
-    readonly chain: EvmChain;
-    readonly from: string;
-    readonly to: string;
-    /** Raw value in wei (BigInt as string for serialization). */
-    readonly valueWei: string;
-    /** USD cents equivalent at detection time (integer). */
-    readonly amountUsdCents: number;
-    readonly txHash: string;
-    readonly blockNumber: number;
-    /** Current confirmation count (latest block - tx block). */
-    readonly confirmations: number;
-    /** Required confirmations for this chain. */
-    readonly confirmationsRequired: number;
-}
-export interface EthWatcherOpts {
-    chain: EvmChain;
-    rpcCall: RpcCall;
-    oracle: IPriceOracle;
-    fromBlock: number;
-    onPayment: (event: EthPaymentEvent) => void | Promise<void>;
-    watchedAddresses?: string[];
-    cursorStore?: IWatcherCursorStore;
-    /** Required confirmations (from DB). */
-    confirmations: number;
-}
-/**
- * Native ETH transfer watcher.
- *
- * Unlike the ERC-20 EvmWatcher which uses eth_getLogs for Transfer events,
- * this scans blocks for transactions where `to` matches a watched deposit
- * address and `value > 0`.
- *
- * Scans up to latest block (not just confirmed) to detect pending txs.
- * Emits events on each confirmation increment. Only advances cursor
- * past fully-confirmed blocks.
- */
-export declare class EthWatcher {
-    private _cursor;
-    private readonly chain;
-    private readonly rpc;
-    private readonly oracle;
-    private readonly onPayment;
-    private readonly confirmations;
-    private readonly cursorStore?;
-    private readonly watcherId;
-    private _watchedAddresses;
-    constructor(opts: EthWatcherOpts);
-    /** Load cursor from DB. Call once at startup before first poll. */
-    init(): Promise<void>;
-    setWatchedAddresses(addresses: string[]): void;
-    get cursor(): number;
-    /**
-     * Poll for native ETH transfers to watched addresses, including unconfirmed blocks.
-     *
-     * Scans from cursor to latest block. Emits events with current confirmation count.
-     * Re-emits on each confirmation increment. Only advances cursor past fully-confirmed blocks.
-     */
-    poll(): Promise<void>;
-}
-export {};

package/dist/billing/crypto/evm/eth-watcher.js

@@ -1,121 +0,0 @@
-import { nativeToCents } from "../oracle/convert.js";
-/**
- * Native ETH transfer watcher.
- *
- * Unlike the ERC-20 EvmWatcher which uses eth_getLogs for Transfer events,
- * this scans blocks for transactions where `to` matches a watched deposit
- * address and `value > 0`.
- *
- * Scans up to latest block (not just confirmed) to detect pending txs.
- * Emits events on each confirmation increment. Only advances cursor
- * past fully-confirmed blocks.
- */
-export class EthWatcher {
-    _cursor;
-    chain;
-    rpc;
-    oracle;
-    onPayment;
-    confirmations;
-    cursorStore;
-    watcherId;
-    _watchedAddresses;
-    constructor(opts) {
-        this.chain = opts.chain;
-        this.rpc = opts.rpcCall;
-        this.oracle = opts.oracle;
-        this._cursor = opts.fromBlock;
-        this.onPayment = opts.onPayment;
-        this.confirmations = opts.confirmations;
-        this.cursorStore = opts.cursorStore;
-        this.watcherId = `eth:${opts.chain}`;
-        this._watchedAddresses = new Set((opts.watchedAddresses ?? []).map((a) => a.toLowerCase()));
-    }
-    /** Load cursor from DB. Call once at startup before first poll. */
-    async init() {
-        if (!this.cursorStore)
-            return;
-        const saved = await this.cursorStore.get(this.watcherId);
-        if (saved !== null)
-            this._cursor = saved;
-    }
-    setWatchedAddresses(addresses) {
-        this._watchedAddresses = new Set(addresses.map((a) => a.toLowerCase()));
-    }
-    get cursor() {
-        return this._cursor;
-    }
-    /**
-     * Poll for native ETH transfers to watched addresses, including unconfirmed blocks.
-     *
-     * Scans from cursor to latest block. Emits events with current confirmation count.
-     * Re-emits on each confirmation increment. Only advances cursor past fully-confirmed blocks.
-     */
-    async poll() {
-        if (this._watchedAddresses.size === 0)
-            return;
-        const latestHex = (await this.rpc("eth_blockNumber", []));
-        const latest = Number.parseInt(latestHex, 16);
-        const confirmed = latest - this.confirmations;
-        if (latest < this._cursor)
-            return;
-        const { priceMicros } = await this.oracle.getPrice("ETH");
-        // Scan up to latest (not just confirmed) to detect pending txs.
-        // Fetch blocks in batches to avoid bursting RPC rate limits on fast chains (e.g. Tron 3s blocks).
-        const BATCH_SIZE = 5;
-        for (let batchStart = this._cursor; batchStart <= latest; batchStart += BATCH_SIZE) {
-            const batchEnd = Math.min(batchStart + BATCH_SIZE - 1, latest);
-            const blockNums = Array.from({ length: batchEnd - batchStart + 1 }, (_, i) => batchStart + i);
-            const blocks = await Promise.all(blockNums.map((bn) => this.rpc("eth_getBlockByNumber", [`0x${bn.toString(16)}`, true]).then((b) => ({ blockNum: bn, block: b, error: null }), (err) => ({ blockNum: bn, block: null, error: err }))));
-            // Stop processing at the first failed block so the cursor doesn't advance past it.
-            const firstFailIdx = blocks.findIndex((b) => b.error !== null || !b.block);
-            const safeBlocks = firstFailIdx === -1 ? blocks : blocks.slice(0, firstFailIdx);
-            for (const { blockNum, block } of safeBlocks) {
-                if (!block)
-                    break;
-                const confs = latest - blockNum;
-                for (const tx of block.transactions) {
-                    if (!tx.to)
-                        continue;
-                    const to = tx.to.toLowerCase();
-                    if (!this._watchedAddresses.has(to))
-                        continue;
-                    const valueWei = BigInt(tx.value);
-                    if (valueWei === 0n)
-                        continue;
-                    // Skip if we already emitted at this confirmation count
-                    if (this.cursorStore) {
-                        const lastConf = await this.cursorStore.getConfirmationCount(this.watcherId, tx.hash);
-                        if (lastConf !== null && confs <= lastConf)
-                            continue;
-                    }
-                    const amountUsdCents = nativeToCents(valueWei, priceMicros, 18);
-                    const event = {
-                        chain: this.chain,
-                        from: tx.from.toLowerCase(),
-                        to,
-                        valueWei: valueWei.toString(),
-                        amountUsdCents,
-                        txHash: tx.hash,
-                        blockNumber: blockNum,
-                        confirmations: confs,
-                        confirmationsRequired: this.confirmations,
-                    };
-                    await this.onPayment(event);
-                    if (this.cursorStore) {
-                        await this.cursorStore.saveConfirmationCount(this.watcherId, tx.hash, confs);
-                    }
-                }
-                // Only advance cursor past fully-confirmed blocks
-                if (blockNum <= confirmed) {
-                    this._cursor = blockNum + 1;
-                    if (this.cursorStore) {
-                        await this.cursorStore.save(this.watcherId, this._cursor);
-                    }
-                }
-            }
-            if (firstFailIdx !== -1)
-                break;
-        }
-    }
-}

package/dist/billing/crypto/evm/watcher.d.ts

@@ -1,51 +0,0 @@
-import type { IWatcherCursorStore } from "../cursor-store.js";
-import type { EvmChain, EvmPaymentEvent, StablecoinToken } from "./types.js";
-type RpcCall = (method: string, params: unknown[]) => Promise<unknown>;
-export interface EvmWatcherOpts {
-    chain: EvmChain;
-    token: StablecoinToken;
-    rpcCall: RpcCall;
-    fromBlock: number;
-    onPayment: (event: EvmPaymentEvent) => void | Promise<void>;
-    /** Active deposit addresses to watch. Filters eth_getLogs by topic[2] (to address). */
-    watchedAddresses?: string[];
-    cursorStore?: IWatcherCursorStore;
-    /** Contract address for the ERC20 token (from DB). */
-    contractAddress: string;
-    /** Token decimals (from DB). */
-    decimals: number;
-    /** Required confirmations (from DB). */
-    confirmations: number;
-}
-export declare class EvmWatcher {
-    private _cursor;
-    private readonly chain;
-    private readonly token;
-    private readonly rpc;
-    private readonly onPayment;
-    private readonly confirmations;
-    private readonly contractAddress;
-    private readonly decimals;
-    private readonly cursorStore?;
-    private readonly watcherId;
-    private _watchedAddresses;
-    constructor(opts: EvmWatcherOpts);
-    /** Load cursor from DB. Call once at startup before first poll. */
-    init(): Promise<void>;
-    /** Update the set of watched deposit addresses (e.g. after a new checkout). */
-    setWatchedAddresses(addresses: string[]): void;
-    get cursor(): number;
-    /**
-     * Poll for Transfer events, including pending (unconfirmed) blocks.
-     *
-     * Two-phase scan:
-     *   1. Scan cursor..latest for new/updated txs, emit with current confirmation count
-     *   2. Re-check pending txs automatically since cursor doesn't advance past unconfirmed blocks
-     *
-     * Cursor only advances past fully-confirmed blocks.
-     */
-    poll(): Promise<void>;
-}
-/** Create an RPC caller for a given URL (plain JSON-RPC over fetch). */
-export declare function createRpcCaller(rpcUrl: string, extraHeaders?: Record<string, string>): RpcCall;
-export {};