@xdc.org/interaction-detector 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,58 @@
+/**
+ * Simple structured logger — no external dependencies.
+ * Supports log levels: debug, info, warn, error, silent.
+ */
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+const LEVEL_COLORS = {
+    debug: '\x1b[90m', // gray
+    info: '\x1b[36m', // cyan
+    warn: '\x1b[33m', // yellow
+    error: '\x1b[31m', // red
+};
+const RESET = '\x1b[0m';
+export class Logger {
+    context;
+    level;
+    constructor(context, level = 'info') {
+        this.context = context;
+        this.level = LEVEL_ORDER[level];
+    }
+    debug(message, ...args) {
+        if (this.level <= LEVEL_ORDER.debug) {
+            this.log('debug', message, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.level <= LEVEL_ORDER.info) {
+            this.log('info', message, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.level <= LEVEL_ORDER.warn) {
+            this.log('warn', message, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.level <= LEVEL_ORDER.error) {
+            this.log('error', message, ...args);
+        }
+    }
+    log(level, message, ...args) {
+        const color = LEVEL_COLORS[level] ?? '';
+        const ts = new Date().toISOString().slice(11, 23); // HH:MM:SS.mmm
+        const prefix = `${color}[${ts}] [${level.toUpperCase()}] [${this.context}]${RESET}`;
+        if (args.length > 0) {
+            console.log(prefix, message, ...args);
+        }
+        else {
+            console.log(prefix, message);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,UAAU,EAAG,OAAO;IAC3B,IAAI,EAAE,UAAU,EAAI,OAAO;IAC3B,IAAI,EAAE,UAAU,EAAI,SAAS;IAC7B,KAAK,EAAE,UAAU,EAAG,MAAM;CAC3B,CAAC;AAEF,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,MAAM,OAAO,MAAM;IACA,OAAO,CAAS;IAChB,KAAK,CAAS;IAE/B,YAAY,OAAe,EAAE,QAAkB,MAAM;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAEO,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,GAAG,IAAW;QACxD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe;QAClE,MAAM,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC;QACpF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

package/dist/watcher/contract-watcher.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ContractWatcher — Real-time contract interaction monitoring.
+ *
+ * Combines three detection paths:
+ *   1. WebSocket subscription (eth_subscribe("logs")) — real-time push
+ *   2. HTTP polling (eth_getLogs) — reliable fallback
+ *   3. Explorer API (txlist + txlistinternal) — direct & internal call discovery
+ *
+ * Deduplication: events are keyed by `txHash-logIndex` to prevent double-counting
+ * when both WS and polling detect the same event.
+ *
+ * EventEmitter API: on('event'), on('interaction'), on('log'), on('connected'),
+ * on('disconnected'), on('error'), on('checkpoint').
+ */
+import { EventEmitter } from 'events';
+import type { InteractionDetectorConfig } from '../types/index.js';
+export declare class ContractWatcher extends EventEmitter {
+    private readonly logger;
+    private readonly logLevel;
+    private readonly rpc;
+    private readonly addresses;
+    private readonly decoder;
+    private readonly registry;
+    private readonly poller;
+    private readonly checkpoint;
+    private readonly checkpointKey;
+    private readonly pollIntervalMs;
+    private readonly explorerPollIntervalMs;
+    private wsManager;
+    private explorer;
+    private pollTimer;
+    private explorerTimer;
+    private lastProcessedBlock;
+    private lastExplorerBlock;
+    private seenEventKeys;
+    private seenTxHashes;
+    private running;
+    private blockTimestampCache;
+    constructor(config: InteractionDetectorConfig);
+    /**
+     * Start monitoring. Begins WS subscription + polling loop + optional explorer polling.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop monitoring gracefully.
+     */
+    stop(): Promise<void>;
+    private setupWsHandlers;
+    private startPolling;
+    private pollCycle;
+    private startExplorerPolling;
+    private explorerPollCycle;
+    private processLog;
+    private resolveTimestamp;
+}
+//# sourceMappingURL=contract-watcher.d.ts.map

package/dist/watcher/contract-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/contract-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAUtC,OAAO,KAAK,EACV,yBAAyB,EAM1B,MAAM,mBAAmB,CAAC;AAO3B,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAEhD,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,OAAO,CAAS;IAGxB,OAAO,CAAC,mBAAmB,CAAkC;gBAEjD,MAAM,EAAE,yBAAyB;IAkD7C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC3B,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,YAAY;YAYN,SAAS;IA6CvB,OAAO,CAAC,oBAAoB;YAgBd,iBAAiB;YA8EjB,UAAU;YA+BV,gBAAgB;CAkB/B"}

package/dist/watcher/contract-watcher.js

@@ -0,0 +1,353 @@
+/**
+ * ContractWatcher — Real-time contract interaction monitoring.
+ *
+ * Combines three detection paths:
+ *   1. WebSocket subscription (eth_subscribe("logs")) — real-time push
+ *   2. HTTP polling (eth_getLogs) — reliable fallback
+ *   3. Explorer API (txlist + txlistinternal) — direct & internal call discovery
+ *
+ * Deduplication: events are keyed by `txHash-logIndex` to prevent double-counting
+ * when both WS and polling detect the same event.
+ *
+ * EventEmitter API: on('event'), on('interaction'), on('log'), on('connected'),
+ * on('disconnected'), on('error'), on('checkpoint').
+ */
+import { EventEmitter } from 'events';
+import { Logger } from '../utils/logger.js';
+import { normalizeAddress } from '../utils/address.js';
+import { RpcClient } from '../rpc/rpc-client.js';
+import { WsManager } from '../rpc/ws-manager.js';
+import { LogPoller } from './log-poller.js';
+import { EventDecoder } from '../decoder/event-decoder.js';
+import { AbiRegistry } from '../decoder/abi-registry.js';
+import { ExplorerClient } from '../explorer/explorer-client.js';
+import { createCheckpointBackend } from '../checkpoint/checkpoint.js';
+const POLL_DEFAULTS = {
+    intervalMs: 30_000,
+    maxBlockRange: 100,
+};
+export class ContractWatcher extends EventEmitter {
+    logger;
+    logLevel;
+    rpc;
+    addresses;
+    decoder;
+    registry;
+    poller;
+    checkpoint;
+    checkpointKey;
+    pollIntervalMs;
+    explorerPollIntervalMs;
+    wsManager = null;
+    explorer = null;
+    pollTimer = null;
+    explorerTimer = null;
+    lastProcessedBlock = 0;
+    lastExplorerBlock = 0;
+    seenEventKeys = new Set();
+    seenTxHashes = new Set();
+    running = false;
+    // Timestamp cache: block number → unix seconds
+    blockTimestampCache = new Map();
+    constructor(config) {
+        super();
+        this.logLevel = config.logLevel ?? 'info';
+        this.logger = new Logger('ContractWatcher', this.logLevel);
+        // Normalize addresses
+        this.addresses = config.contracts.map((c) => normalizeAddress(c.address));
+        // RPC client
+        this.rpc = new RpcClient(config.rpcUrl, {
+            fallbackUrls: config.fallbackRpcUrls,
+            logLevel: this.logLevel,
+        });
+        // ABI registry + decoder
+        this.registry = new AbiRegistry(this.logLevel);
+        for (const contract of config.contracts) {
+            if (contract.abi) {
+                this.registry.register(contract.address, contract.abi, contract.name);
+            }
+        }
+        this.decoder = new EventDecoder(this.registry, this.logLevel);
+        // Log poller
+        this.poller = new LogPoller(this.rpc, this.addresses, config.polling, this.logLevel);
+        this.pollIntervalMs = config.polling?.intervalMs ?? POLL_DEFAULTS.intervalMs;
+        // Checkpoint
+        this.checkpoint = createCheckpointBackend(config.checkpoint);
+        this.checkpointKey = `watcher-${this.addresses.sort().join('-').slice(0, 60)}`;
+        // WebSocket (optional)
+        if (config.wsUrl && config.ws?.enabled !== false) {
+            this.wsManager = new WsManager(config.wsUrl, config.chainId ?? 50, config.ws, this.logLevel);
+        }
+        // Explorer (optional)
+        if (config.explorer) {
+            this.explorer = new ExplorerClient(config.explorer, this.logLevel);
+            this.explorerPollIntervalMs = config.explorer.pollIntervalMs ?? 60_000;
+        }
+        else {
+            this.explorerPollIntervalMs = 0;
+        }
+    }
+    /**
+     * Start monitoring. Begins WS subscription + polling loop + optional explorer polling.
+     */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.logger.info(`Starting ContractWatcher for ${this.addresses.length} contract(s)`);
+        // Restore checkpoint
+        const savedBlock = await this.checkpoint.load(this.checkpointKey);
+        if (savedBlock) {
+            this.lastProcessedBlock = savedBlock;
+            this.lastExplorerBlock = savedBlock;
+            this.logger.info(`Resumed from checkpoint: block ${savedBlock}`);
+        }
+        else {
+            // Start from current block
+            this.lastProcessedBlock = (await this.rpc.getBlockNumber()) - 1;
+            this.lastExplorerBlock = this.lastProcessedBlock;
+            this.logger.info(`Starting from current block: ${this.lastProcessedBlock}`);
+        }
+        // Start WebSocket subscription
+        if (this.wsManager) {
+            this.setupWsHandlers();
+            this.wsManager.connect(this.addresses).catch((err) => {
+                this.logger.warn(`WS connect failed: ${err.message}`);
+            });
+        }
+        // Start polling loop
+        this.startPolling();
+        // Start explorer polling
+        if (this.explorer) {
+            this.startExplorerPolling();
+        }
+    }
+    /**
+     * Stop monitoring gracefully.
+     */
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        this.logger.info('Stopping ContractWatcher...');
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        if (this.explorerTimer) {
+            clearInterval(this.explorerTimer);
+            this.explorerTimer = null;
+        }
+        if (this.wsManager) {
+            await this.wsManager.disconnect();
+        }
+        if (this.explorer) {
+            this.explorer.destroy();
+        }
+        // Save final checkpoint
+        if (this.lastProcessedBlock > 0) {
+            await this.checkpoint.save(this.checkpointKey, this.lastProcessedBlock);
+        }
+        this.logger.info('ContractWatcher stopped');
+    }
+    // ─── WebSocket Handlers ──────────────────────────────────────────────
+    setupWsHandlers() {
+        if (!this.wsManager)
+            return;
+        this.wsManager.on('log', (log) => {
+            this.processLog(log, 'ws_logs').catch((err) => {
+                this.logger.error(`Error processing WS log: ${err.message}`);
+            });
+        });
+        this.wsManager.on('connected', (url) => {
+            this.logger.info(`WS connected: ${url}`);
+            this.emit('connected', { url, type: 'websocket' });
+        });
+        this.wsManager.on('disconnected', (url, reason) => {
+            this.logger.warn(`WS disconnected: ${url} (${reason})`);
+            this.emit('disconnected', { url, reason });
+        });
+        this.wsManager.on('error', (err) => {
+            this.emit('error', err);
+        });
+    }
+    // ─── Polling Loop ─────────────────────────────────────────────────────
+    startPolling() {
+        this.pollCycle().catch((err) => {
+            this.logger.error(`Initial poll failed: ${err.message}`);
+        });
+        this.pollTimer = setInterval(() => {
+            this.pollCycle().catch((err) => {
+                this.logger.error(`Poll cycle failed: ${err.message}`);
+            });
+        }, this.pollIntervalMs);
+    }
+    async pollCycle() {
+        if (!this.running)
+            return;
+        try {
+            const currentBlock = await this.rpc.getBlockNumber();
+            if (currentBlock <= this.lastProcessedBlock) {
+                this.logger.debug(`No new blocks (current: ${currentBlock}, last: ${this.lastProcessedBlock})`);
+                return;
+            }
+            const fromBlock = this.lastProcessedBlock + 1;
+            const toBlock = currentBlock;
+            this.logger.debug(`Polling blocks ${fromBlock}–${toBlock} (${toBlock - fromBlock + 1} blocks)`);
+            const logs = await this.poller.fetchLogs(fromBlock, toBlock);
+            for (const log of logs) {
+                await this.processLog(log, 'rpc_logs');
+            }
+            this.lastProcessedBlock = toBlock;
+            // Save checkpoint
+            await this.checkpoint.save(this.checkpointKey, toBlock);
+            this.emit('checkpoint', toBlock);
+            // Prune old dedup keys
+            if (this.seenEventKeys.size > 15000) {
+                const keysArray = Array.from(this.seenEventKeys);
+                this.seenEventKeys = new Set(keysArray.slice(keysArray.length - 10000));
+            }
+            if (this.seenTxHashes.size > 15000) {
+                const txArray = Array.from(this.seenTxHashes);
+                this.seenTxHashes = new Set(txArray.slice(txArray.length - 10000));
+            }
+        }
+        catch (err) {
+            this.logger.error(`Poll cycle error: ${err.message}`);
+            this.emit('error', err);
+        }
+    }
+    // ─── Explorer Polling ─────────────────────────────────────────────────
+    startExplorerPolling() {
+        if (!this.explorer)
+            return;
+        setTimeout(() => {
+            this.explorerPollCycle().catch((err) => {
+                this.logger.error(`Initial explorer poll failed: ${err.message}`);
+            });
+        }, 5000);
+        this.explorerTimer = setInterval(() => {
+            this.explorerPollCycle().catch((err) => {
+                this.logger.error(`Explorer poll cycle failed: ${err.message}`);
+            });
+        }, this.explorerPollIntervalMs);
+    }
+    async explorerPollCycle() {
+        if (!this.running || !this.explorer)
+            return;
+        const currentBlock = this.lastProcessedBlock;
+        if (currentBlock <= this.lastExplorerBlock)
+            return;
+        for (const address of this.addresses) {
+            try {
+                // Fetch direct transactions
+                const txs = await this.explorer.getTransactions(address, {
+                    startBlock: this.lastExplorerBlock + 1,
+                    endBlock: currentBlock,
+                });
+                for (const tx of txs) {
+                    if (this.seenTxHashes.has(tx.hash))
+                        continue;
+                    this.seenTxHashes.add(tx.hash);
+                    const interaction = {
+                        type: 'direct_call',
+                        txHash: tx.hash,
+                        blockNumber: parseInt(tx.blockNumber),
+                        timestamp: parseInt(tx.timeStamp),
+                        from: tx.from,
+                        to: tx.to,
+                        value: tx.value,
+                        methodId: tx.methodId,
+                        methodName: tx.functionName,
+                        input: tx.input,
+                        gasUsed: tx.gasUsed,
+                        isError: tx.isError === '1',
+                        source: 'explorer_txlist',
+                    };
+                    this.emit('interaction', interaction);
+                }
+                // Fetch internal transactions
+                const internalTxs = await this.explorer.getInternalTransactions(address, {
+                    startBlock: this.lastExplorerBlock + 1,
+                    endBlock: currentBlock,
+                });
+                for (const tx of internalTxs) {
+                    if (this.seenTxHashes.has(`${tx.hash}-internal-${tx.from}-${tx.to}`))
+                        continue;
+                    this.seenTxHashes.add(`${tx.hash}-internal-${tx.from}-${tx.to}`);
+                    const callType = tx.callType?.toLowerCase();
+                    let interactionType = 'internal_call';
+                    if (callType === 'delegatecall')
+                        interactionType = 'delegate_call';
+                    else if (callType === 'staticcall')
+                        interactionType = 'static_call';
+                    else if (callType === 'create')
+                        interactionType = 'create';
+                    const interaction = {
+                        type: interactionType,
+                        txHash: tx.hash,
+                        blockNumber: parseInt(tx.blockNumber),
+                        timestamp: parseInt(tx.timeStamp),
+                        from: tx.from,
+                        to: tx.to,
+                        value: tx.value,
+                        gasUsed: tx.gasUsed,
+                        isError: tx.isError === '1',
+                        source: 'explorer_internal',
+                    };
+                    this.emit('interaction', interaction);
+                }
+            }
+            catch (err) {
+                this.logger.warn(`Explorer poll failed for ${address}: ${err.message}`);
+            }
+        }
+        this.lastExplorerBlock = currentBlock;
+    }
+    // ─── Log Processing ───────────────────────────────────────────────────
+    async processLog(log, source) {
+        const logIndex = typeof log.logIndex === 'string'
+            ? parseInt(log.logIndex, 16)
+            : log.logIndex;
+        const dedupKey = `${log.transactionHash}-${logIndex}`;
+        if (this.seenEventKeys.has(dedupKey))
+            return;
+        this.seenEventKeys.add(dedupKey);
+        this.emit('log', log);
+        const decoded = this.decoder.decode(log);
+        if (decoded) {
+            decoded.timestamp = await this.resolveTimestamp(decoded.blockNumber);
+            this.emit('event', decoded);
+            const interaction = {
+                type: 'event',
+                txHash: decoded.txHash,
+                blockNumber: decoded.blockNumber,
+                timestamp: decoded.timestamp,
+                from: '',
+                to: decoded.contract,
+                value: '0',
+                event: decoded,
+                source,
+            };
+            this.emit('interaction', interaction);
+        }
+    }
+    async resolveTimestamp(blockNumber) {
+        const cached = this.blockTimestampCache.get(blockNumber);
+        if (cached !== undefined)
+            return cached;
+        try {
+            const timestamp = await this.rpc.getBlockTimestamp(blockNumber);
+            this.blockTimestampCache.set(blockNumber, timestamp);
+            if (this.blockTimestampCache.size > 600) {
+                const entries = Array.from(this.blockTimestampCache.entries());
+                this.blockTimestampCache = new Map(entries.slice(entries.length - 500));
+            }
+            return timestamp;
+        }
+        catch {
+            return Math.floor(Date.now() / 1000);
+        }
+    }
+}
+//# sourceMappingURL=contract-watcher.js.map

package/dist/watcher/contract-watcher.js.map

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

package/dist/watcher/log-poller.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Log Poller — fetches logs via eth_getLogs in chunked block ranges.
+ *
+ * Handles XDC's 100-block-per-request limit with automatic chunking.
+ * Used by ContractWatcher as the reliable fallback to WebSocket.
+ */
+import { RpcClient } from '../rpc/rpc-client.js';
+import type { RawLog, PollingConfig, LogLevel } from '../types/index.js';
+export declare class LogPoller {
+    private readonly logger;
+    private readonly rpc;
+    private readonly addresses;
+    private readonly maxBlockRange;
+    private readonly concurrency;
+    constructor(rpc: RpcClient, addresses: string[], config?: PollingConfig, logLevel?: LogLevel);
+    /**
+     * Fetch all logs from `fromBlock` to `toBlock` for the monitored addresses.
+     * Automatically chunks into maxBlockRange-sized requests.
+     */
+    fetchLogs(fromBlock: number, toBlock: number): Promise<RawLog[]>;
+    private fetchChunk;
+    private toNumber;
+}
+//# sourceMappingURL=log-poller.d.ts.map

package/dist/watcher/log-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-poller.d.ts","sourceRoot":"","sources":["../../src/watcher/log-poller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEzE,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGnC,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,CAAC,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,QAAQ;IASrB;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAyCxD,UAAU;IAexB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/watcher/log-poller.js

@@ -0,0 +1,82 @@
+/**
+ * Log Poller — fetches logs via eth_getLogs in chunked block ranges.
+ *
+ * Handles XDC's 100-block-per-request limit with automatic chunking.
+ * Used by ContractWatcher as the reliable fallback to WebSocket.
+ */
+import { Logger } from '../utils/logger.js';
+export class LogPoller {
+    logger;
+    rpc;
+    addresses;
+    maxBlockRange;
+    concurrency;
+    constructor(rpc, addresses, config, logLevel) {
+        this.rpc = rpc;
+        this.addresses = addresses;
+        this.maxBlockRange = config?.maxBlockRange ?? 100;
+        this.concurrency = config?.concurrency ?? 3;
+        this.logger = new Logger('LogPoller', logLevel ?? 'info');
+    }
+    /**
+     * Fetch all logs from `fromBlock` to `toBlock` for the monitored addresses.
+     * Automatically chunks into maxBlockRange-sized requests.
+     */
+    async fetchLogs(fromBlock, toBlock) {
+        if (fromBlock > toBlock)
+            return [];
+        const totalBlocks = toBlock - fromBlock + 1;
+        if (totalBlocks <= this.maxBlockRange) {
+            return this.fetchChunk(fromBlock, toBlock);
+        }
+        // Split into chunks
+        const chunks = [];
+        let current = fromBlock;
+        while (current <= toBlock) {
+            const chunkEnd = Math.min(current + this.maxBlockRange - 1, toBlock);
+            chunks.push({ from: current, to: chunkEnd });
+            current = chunkEnd + 1;
+        }
+        this.logger.debug(`Fetching logs: ${chunks.length} chunks (blocks ${fromBlock}–${toBlock})`);
+        // Execute chunks with concurrency control
+        const allLogs = [];
+        for (let i = 0; i < chunks.length; i += this.concurrency) {
+            const batch = chunks.slice(i, i + this.concurrency);
+            const results = await Promise.all(batch.map((chunk) => this.fetchChunk(chunk.from, chunk.to)));
+            for (const logs of results) {
+                allLogs.push(...logs);
+            }
+        }
+        // Sort by block number, then log index
+        allLogs.sort((a, b) => {
+            const blockDiff = this.toNumber(a.blockNumber) - this.toNumber(b.blockNumber);
+            if (blockDiff !== 0)
+                return blockDiff;
+            return this.toNumber(a.logIndex) - this.toNumber(b.logIndex);
+        });
+        return allLogs;
+    }
+    async fetchChunk(fromBlock, toBlock) {
+        try {
+            const logs = await this.rpc.getLogs({
+                address: this.addresses,
+                fromBlock,
+                toBlock,
+            });
+            this.logger.debug(`Fetched ${logs.length} logs from blocks ${fromBlock}–${toBlock}`);
+            return logs;
+        }
+        catch (err) {
+            this.logger.error(`Failed to fetch logs ${fromBlock}–${toBlock}: ${err.message}`);
+            return [];
+        }
+    }
+    toNumber(value) {
+        if (typeof value === 'number')
+            return value;
+        if (value.startsWith('0x') || value.startsWith('0X'))
+            return parseInt(value, 16);
+        return parseInt(value, 10);
+    }
+}
+//# sourceMappingURL=log-poller.js.map

package/dist/watcher/log-poller.js.map

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