@waiaas/daemon 2.5.0 → 2.6.0-rc.1

package/dist/services/incoming/__tests__/integration-wiring.test.js

@@ -0,0 +1,355 @@
+/**
+ * Integration wiring tests for incoming TX monitoring pipeline.
+ *
+ * Verifies the 3 bug fixes from Plan 01 (Phase 230) work correctly
+ * when components are wired together:
+ *
+ *   BUG-1: BackgroundWorkers instance sharing -- monitor registers 6 workers to the provided instance
+ *   BUG-2: Polling worker handlers -- invoke subscriber.pollAll() for solana and ethereum chains
+ *   BUG-3: Gap recovery wiring -- onGapRecovery invokes createGapRecoveryHandler -> subscriber.pollAll()
+ *
+ * These tests use real IncomingTxMonitorService with mock boundaries (DB, IChainSubscriber)
+ * to verify cross-component wiring at the integration level.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { IncomingTxMonitorService } from '../incoming-tx-monitor-service.js';
+// ---------------------------------------------------------------------------
+// Mock generateId for queue flush
+// ---------------------------------------------------------------------------
+let idCounter = 0;
+vi.mock('../../../infrastructure/database/id.js', () => ({
+    generateId: () => `uuid-${++idCounter}`,
+}));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeConfig(overrides = {}) {
+    return {
+        enabled: true,
+        pollIntervalSec: 30,
+        retentionDays: 90,
+        dustThresholdUsd: 0.01,
+        amountMultiplier: 10,
+        cooldownMinutes: 5,
+        ...overrides,
+    };
+}
+function createMockSqlite() {
+    const runFn = vi.fn().mockReturnValue({ changes: 1 });
+    const getFn = vi.fn().mockReturnValue(undefined);
+    const allFn = vi.fn().mockReturnValue([]);
+    const prepareFn = vi.fn().mockReturnValue({
+        run: runFn,
+        get: getFn,
+        all: allFn,
+    });
+    const txFn = vi.fn((fn) => fn);
+    return {
+        prepare: prepareFn,
+        transaction: txFn,
+        exec: vi.fn(),
+        _runFn: runFn,
+        _getFn: getFn,
+        _allFn: allFn,
+        _prepareFn: prepareFn,
+    };
+}
+function createMockEventBus() {
+    return {
+        emit: vi.fn().mockReturnValue(true),
+        on: vi.fn(),
+        removeAllListeners: vi.fn(),
+        listenerCount: vi.fn().mockReturnValue(0),
+    };
+}
+function createMockWorkers() {
+    return {
+        register: vi.fn(),
+        startAll: vi.fn(),
+        stopAll: vi.fn(),
+        size: 0,
+        isRunning: vi.fn().mockReturnValue(false),
+    };
+}
+function createMockSubscriberFactory() {
+    return vi.fn().mockReturnValue({
+        connect: vi.fn().mockResolvedValue(undefined),
+        waitForDisconnect: vi.fn().mockReturnValue(new Promise(() => { })),
+        subscribe: vi.fn().mockResolvedValue(undefined),
+        unsubscribe: vi.fn().mockResolvedValue(undefined),
+        pollAll: vi.fn().mockResolvedValue(undefined),
+        destroy: vi.fn().mockResolvedValue(undefined),
+    });
+}
+/** Create a fresh IncomingTxMonitorService with isolated mocks. */
+function createFreshService(opts = {}) {
+    const sqlite = createMockSqlite();
+    const eventBus = createMockEventBus();
+    const workers = createMockWorkers();
+    const subscriberFactory = createMockSubscriberFactory();
+    // Return empty wallets from DB query
+    sqlite._allFn.mockReturnValue([]);
+    const service = new IncomingTxMonitorService({
+        sqlite: sqlite,
+        db: {},
+        workers: workers,
+        eventBus: eventBus,
+        killSwitchService: null,
+        notificationService: null,
+        subscriberFactory,
+        config: makeConfig(opts.configOverrides),
+    });
+    return { service, sqlite, eventBus, workers, subscriberFactory };
+}
+// ===========================================================================
+// Section 1: BUG-1 -- BackgroundWorkers Instance Sharing
+// ===========================================================================
+describe('BUG-1: BackgroundWorkers Instance Sharing', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        idCounter = 0;
+    });
+    it('monitor service registers workers to the provided BackgroundWorkers instance', async () => {
+        const { service, workers } = createFreshService();
+        await service.start();
+        // Assert workers.register was called exactly 6 times
+        expect(workers.register).toHaveBeenCalledTimes(6);
+        // Assert the exact 6 worker names
+        const registeredNames = workers.register.mock.calls.map((call) => call[0]);
+        expect(registeredNames).toEqual(expect.arrayContaining([
+            'incoming-tx-flush',
+            'incoming-tx-retention',
+            'incoming-tx-confirm-solana',
+            'incoming-tx-confirm-evm',
+            'incoming-tx-poll-solana',
+            'incoming-tx-poll-evm',
+        ]));
+        // Verify exactly these 6 (no more, no less)
+        expect(registeredNames).toHaveLength(6);
+        await service.stop();
+    });
+    it('all registered worker handlers are callable functions', async () => {
+        const { service, workers } = createFreshService();
+        await service.start();
+        // Extract handler functions from workers.register.mock.calls
+        for (const call of workers.register.mock.calls) {
+            const config = call[1];
+            // Each registered worker should have a handler that is a function
+            expect(typeof config.handler).toBe('function');
+            // Call each handler and assert it does not throw
+            const handler = config.handler;
+            await expect(handler()).resolves.not.toThrow();
+        }
+        await service.stop();
+    });
+});
+// ===========================================================================
+// Section 2: BUG-2 -- Polling Worker Handlers
+// ===========================================================================
+describe('BUG-2: Polling Worker Handlers', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        idCounter = 0;
+    });
+    it('Solana polling worker calls pollAll() on solana subscribers', async () => {
+        const sqlite = createMockSqlite();
+        const eventBus = createMockEventBus();
+        const workers = createMockWorkers();
+        const mockPollAll = vi.fn().mockResolvedValue(undefined);
+        const subscriberFactory = vi.fn().mockReturnValue({
+            connect: vi.fn().mockResolvedValue(undefined),
+            waitForDisconnect: vi.fn().mockReturnValue(new Promise(() => { })),
+            subscribe: vi.fn().mockResolvedValue(undefined),
+            unsubscribe: vi.fn().mockResolvedValue(undefined),
+            pollAll: mockPollAll,
+            destroy: vi.fn().mockResolvedValue(undefined),
+        });
+        // Return one solana wallet from DB
+        sqlite._allFn.mockReturnValueOnce([
+            { id: 'w1', chain: 'solana', network: 'mainnet', public_key: 'pk1' },
+        ]);
+        const service = new IncomingTxMonitorService({
+            sqlite: sqlite,
+            db: {},
+            workers: workers,
+            eventBus: eventBus,
+            killSwitchService: null,
+            notificationService: null,
+            subscriberFactory,
+            config: makeConfig(),
+        });
+        await service.start();
+        // Extract 'incoming-tx-poll-solana' handler
+        const pollSolanaCall = workers.register.mock.calls.find((call) => call[0] === 'incoming-tx-poll-solana');
+        expect(pollSolanaCall).toBeDefined();
+        const handler = pollSolanaCall[1].handler;
+        await handler();
+        // Assert subscriber.pollAll() was called
+        expect(mockPollAll).toHaveBeenCalledTimes(1);
+        await service.stop();
+    });
+    it('EVM polling worker calls pollAll() on ethereum subscribers', async () => {
+        const sqlite = createMockSqlite();
+        const eventBus = createMockEventBus();
+        const workers = createMockWorkers();
+        const mockPollAll = vi.fn().mockResolvedValue(undefined);
+        const subscriberFactory = vi.fn().mockReturnValue({
+            connect: vi.fn().mockResolvedValue(undefined),
+            waitForDisconnect: vi.fn().mockReturnValue(new Promise(() => { })),
+            subscribe: vi.fn().mockResolvedValue(undefined),
+            unsubscribe: vi.fn().mockResolvedValue(undefined),
+            pollAll: mockPollAll,
+            destroy: vi.fn().mockResolvedValue(undefined),
+        });
+        // Return one ethereum wallet from DB
+        sqlite._allFn.mockReturnValueOnce([
+            { id: 'w2', chain: 'ethereum', network: 'mainnet', public_key: 'pk2' },
+        ]);
+        const service = new IncomingTxMonitorService({
+            sqlite: sqlite,
+            db: {},
+            workers: workers,
+            eventBus: eventBus,
+            killSwitchService: null,
+            notificationService: null,
+            subscriberFactory,
+            config: makeConfig(),
+        });
+        await service.start();
+        // Extract 'incoming-tx-poll-evm' handler
+        const pollEvmCall = workers.register.mock.calls.find((call) => call[0] === 'incoming-tx-poll-evm');
+        expect(pollEvmCall).toBeDefined();
+        const handler = pollEvmCall[1].handler;
+        await handler();
+        // Assert subscriber.pollAll() was called
+        expect(mockPollAll).toHaveBeenCalledTimes(1);
+        await service.stop();
+    });
+    it('polling worker handles subscriber.pollAll() errors gracefully', async () => {
+        const sqlite = createMockSqlite();
+        const eventBus = createMockEventBus();
+        const workers = createMockWorkers();
+        const mockPollAll = vi.fn().mockRejectedValue(new Error('RPC timeout'));
+        const subscriberFactory = vi.fn().mockReturnValue({
+            connect: vi.fn().mockResolvedValue(undefined),
+            waitForDisconnect: vi.fn().mockReturnValue(new Promise(() => { })),
+            subscribe: vi.fn().mockResolvedValue(undefined),
+            unsubscribe: vi.fn().mockResolvedValue(undefined),
+            pollAll: mockPollAll,
+            destroy: vi.fn().mockResolvedValue(undefined),
+        });
+        // Return one solana wallet from DB
+        sqlite._allFn.mockReturnValueOnce([
+            { id: 'w1', chain: 'solana', network: 'mainnet', public_key: 'pk1' },
+        ]);
+        const service = new IncomingTxMonitorService({
+            sqlite: sqlite,
+            db: {},
+            workers: workers,
+            eventBus: eventBus,
+            killSwitchService: null,
+            notificationService: null,
+            subscriberFactory,
+            config: makeConfig(),
+        });
+        await service.start();
+        // Extract 'incoming-tx-poll-solana' handler
+        const pollSolanaCall = workers.register.mock.calls.find((call) => call[0] === 'incoming-tx-poll-solana');
+        const handler = pollSolanaCall[1].handler;
+        // Spy on console.warn to verify error logging
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        // Should NOT throw -- error is caught and logged
+        await expect(handler()).resolves.not.toThrow();
+        // Verify warning was logged
+        expect(warnSpy).toHaveBeenCalledWith('Solana polling worker error:', expect.any(Error));
+        warnSpy.mockRestore();
+        await service.stop();
+    });
+});
+// ===========================================================================
+// Section 3: BUG-3 -- Gap Recovery Wiring
+// ===========================================================================
+describe('BUG-3: Gap Recovery Wiring', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        idCounter = 0;
+    });
+    it('onGapRecovery invokes createGapRecoveryHandler which calls subscriber.pollAll()', async () => {
+        const sqlite = createMockSqlite();
+        const eventBus = createMockEventBus();
+        const workers = createMockWorkers();
+        const mockPollAll = vi.fn().mockResolvedValue(undefined);
+        const subscriberFactory = vi.fn().mockReturnValue({
+            connect: vi.fn().mockResolvedValue(undefined),
+            waitForDisconnect: vi.fn().mockReturnValue(new Promise(() => { })),
+            subscribe: vi.fn().mockResolvedValue(undefined),
+            unsubscribe: vi.fn().mockResolvedValue(undefined),
+            pollAll: mockPollAll,
+            destroy: vi.fn().mockResolvedValue(undefined),
+        });
+        // Return one solana wallet from DB
+        sqlite._allFn.mockReturnValueOnce([
+            { id: 'w1', chain: 'solana', network: 'mainnet', public_key: 'pk1' },
+        ]);
+        const service = new IncomingTxMonitorService({
+            sqlite: sqlite,
+            db: {},
+            workers: workers,
+            eventBus: eventBus,
+            killSwitchService: null,
+            notificationService: null,
+            subscriberFactory,
+            config: makeConfig(),
+        });
+        await service.start();
+        // Access the multiplexer's onGapRecovery callback via internal deps
+        const multiplexer = service.multiplexer;
+        const onGapRecovery = multiplexer.deps.onGapRecovery;
+        expect(onGapRecovery).toBeDefined();
+        expect(typeof onGapRecovery).toBe('function');
+        // Call onGapRecovery for solana:mainnet
+        await onGapRecovery('solana', 'mainnet', ['w1']);
+        // Assert subscriber.pollAll() was called (via createGapRecoveryHandler -> entry.subscriber.pollAll())
+        expect(mockPollAll).toHaveBeenCalledTimes(1);
+        await service.stop();
+    });
+    it('onGapRecovery handles missing chain:network gracefully', async () => {
+        const sqlite = createMockSqlite();
+        const eventBus = createMockEventBus();
+        const workers = createMockWorkers();
+        const mockPollAll = vi.fn().mockResolvedValue(undefined);
+        const subscriberFactory = vi.fn().mockReturnValue({
+            connect: vi.fn().mockResolvedValue(undefined),
+            waitForDisconnect: vi.fn().mockReturnValue(new Promise(() => { })),
+            subscribe: vi.fn().mockResolvedValue(undefined),
+            unsubscribe: vi.fn().mockResolvedValue(undefined),
+            pollAll: mockPollAll,
+            destroy: vi.fn().mockResolvedValue(undefined),
+        });
+        // Only return a solana wallet (no ethereum)
+        sqlite._allFn.mockReturnValueOnce([
+            { id: 'w1', chain: 'solana', network: 'mainnet', public_key: 'pk1' },
+        ]);
+        const service = new IncomingTxMonitorService({
+            sqlite: sqlite,
+            db: {},
+            workers: workers,
+            eventBus: eventBus,
+            killSwitchService: null,
+            notificationService: null,
+            subscriberFactory,
+            config: makeConfig(),
+        });
+        await service.start();
+        // Access onGapRecovery
+        const multiplexer = service.multiplexer;
+        const onGapRecovery = multiplexer.deps.onGapRecovery;
+        // Call onGapRecovery for 'ethereum:mainnet' which has no subscriber
+        // Should NOT throw -- createGapRecoveryHandler gracefully skips missing entries
+        await expect(onGapRecovery('ethereum', 'mainnet', ['w1'])).resolves.not.toThrow();
+        // solana pollAll should NOT have been called (we requested ethereum)
+        expect(mockPollAll).not.toHaveBeenCalled();
+        await service.stop();
+    });
+});
+//# sourceMappingURL=integration-wiring.test.js.map

package/dist/services/incoming/__tests__/integration-wiring.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-wiring.test.js","sourceRoot":"","sources":["../../../../src/services/incoming/__tests__/integration-wiring.test.ts"],"names":[],"mappings":"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"}

package/dist/services/incoming/__tests__/safety-rules.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for incoming transaction safety rules.
+ *
+ * Covers all 3 rule implementations with edge cases:
+ * - DustAttackRule: below/above threshold, null usdPrice
+ * - UnknownTokenRule: unregistered token, registered token, native transfer
+ * - LargeAmountRule: above/below multiplier, null avg, null price
+ */
+export {};
+//# sourceMappingURL=safety-rules.test.d.ts.map

package/dist/services/incoming/__tests__/safety-rules.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-rules.test.d.ts","sourceRoot":"","sources":["../../../../src/services/incoming/__tests__/safety-rules.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/services/incoming/__tests__/safety-rules.test.js

@@ -0,0 +1,165 @@
+/**
+ * Tests for incoming transaction safety rules.
+ *
+ * Covers all 3 rule implementations with edge cases:
+ * - DustAttackRule: below/above threshold, null usdPrice
+ * - UnknownTokenRule: unregistered token, registered token, native transfer
+ * - LargeAmountRule: above/below multiplier, null avg, null price
+ */
+import { describe, it, expect } from 'vitest';
+import { DustAttackRule, UnknownTokenRule, LargeAmountRule, } from '../safety-rules.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTx(overrides = {}) {
+    return {
+        id: 'tx-001',
+        txHash: '0xabc',
+        walletId: 'wallet-001',
+        fromAddress: '0xsender',
+        amount: '1000000000', // 1 SOL in lamports (9 decimals)
+        tokenAddress: null,
+        chain: 'solana',
+        network: 'mainnet',
+        status: 'DETECTED',
+        blockNumber: 100,
+        detectedAt: 1700000000,
+        confirmedAt: null,
+        isSuspicious: false,
+        ...overrides,
+    };
+}
+function makeContext(overrides = {}) {
+    return {
+        dustThresholdUsd: 0.01,
+        amountMultiplier: 10,
+        isRegisteredToken: true,
+        usdPrice: 100, // $100 per whole token
+        avgIncomingUsd: 500, // average incoming is $500
+        decimals: 9,
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// DustAttackRule
+// ---------------------------------------------------------------------------
+describe('DustAttackRule', () => {
+    const rule = new DustAttackRule();
+    it('has name "dust"', () => {
+        expect(rule.name).toBe('dust');
+    });
+    it('flags transaction below dust threshold', () => {
+        // amount=10 lamports, price=$100, decimals=9 -> USD = 10 * 100 / 1e9 = 0.000001
+        const tx = makeTx({ amount: '10' });
+        const ctx = makeContext({ dustThresholdUsd: 0.01 });
+        expect(rule.check(tx, ctx)).toBe(true);
+    });
+    it('does not flag transaction above dust threshold', () => {
+        // amount=1e9 (1 SOL), price=$100 -> USD = 100
+        const tx = makeTx({ amount: '1000000000' });
+        const ctx = makeContext({ dustThresholdUsd: 0.01 });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('returns false when usdPrice is null (safe default)', () => {
+        const tx = makeTx({ amount: '10' });
+        const ctx = makeContext({ usdPrice: null });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('flags when USD value exactly equals threshold', () => {
+        // amount * price / 10^decimals = 0.01
+        // amount = 0.01 * 1e9 / 100 = 100000
+        const tx = makeTx({ amount: '100000' });
+        const ctx = makeContext({ dustThresholdUsd: 0.01, usdPrice: 100, decimals: 9 });
+        // 100000 * 100 / 1e9 = 0.01 -- NOT less than threshold
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('handles EVM decimals (18)', () => {
+        // amount=100 wei, price=$2000, decimals=18 -> USD = 100 * 2000 / 1e18 = 0.0000000000000002
+        const tx = makeTx({ amount: '100', chain: 'ethereum' });
+        const ctx = makeContext({ usdPrice: 2000, decimals: 18, dustThresholdUsd: 0.01 });
+        expect(rule.check(tx, ctx)).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// UnknownTokenRule
+// ---------------------------------------------------------------------------
+describe('UnknownTokenRule', () => {
+    const rule = new UnknownTokenRule();
+    it('has name "unknownToken"', () => {
+        expect(rule.name).toBe('unknownToken');
+    });
+    it('flags token transfer with unregistered token', () => {
+        const tx = makeTx({ tokenAddress: '0xunknown' });
+        const ctx = makeContext({ isRegisteredToken: false });
+        expect(rule.check(tx, ctx)).toBe(true);
+    });
+    it('does not flag token transfer with registered token', () => {
+        const tx = makeTx({ tokenAddress: '0xknown' });
+        const ctx = makeContext({ isRegisteredToken: true });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('does not flag native transfer (tokenAddress = null)', () => {
+        const tx = makeTx({ tokenAddress: null });
+        const ctx = makeContext({ isRegisteredToken: false });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
+// LargeAmountRule
+// ---------------------------------------------------------------------------
+describe('LargeAmountRule', () => {
+    const rule = new LargeAmountRule();
+    it('has name "largeAmount"', () => {
+        expect(rule.name).toBe('largeAmount');
+    });
+    it('flags transaction above multiplier * average', () => {
+        // amount=100e9 lamports (100 SOL), price=$100, decimals=9 -> USD = 10000
+        // avgIncoming=$500, multiplier=10 -> threshold = $5000
+        // 10000 > 5000 -> flagged
+        const tx = makeTx({ amount: '100000000000' });
+        const ctx = makeContext({
+            usdPrice: 100,
+            avgIncomingUsd: 500,
+            amountMultiplier: 10,
+            decimals: 9,
+        });
+        expect(rule.check(tx, ctx)).toBe(true);
+    });
+    it('does not flag transaction below multiplier * average', () => {
+        // amount=1e9 (1 SOL), price=$100 -> USD = 100
+        // avgIncoming=$500, multiplier=10 -> threshold = $5000
+        // 100 < 5000 -> not flagged
+        const tx = makeTx({ amount: '1000000000' });
+        const ctx = makeContext({
+            usdPrice: 100,
+            avgIncomingUsd: 500,
+            amountMultiplier: 10,
+            decimals: 9,
+        });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('returns false when avgIncomingUsd is null (safe default)', () => {
+        const tx = makeTx({ amount: '100000000000' });
+        const ctx = makeContext({ avgIncomingUsd: null });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('returns false when usdPrice is null (safe default)', () => {
+        const tx = makeTx({ amount: '100000000000' });
+        const ctx = makeContext({ usdPrice: null });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+    it('does not flag when exactly at multiplier * average', () => {
+        // amount=50e9 (50 SOL), price=$100 -> USD = 5000
+        // avgIncoming=$500, multiplier=10 -> threshold = $5000
+        // 5000 > 5000 is false -> not flagged
+        const tx = makeTx({ amount: '50000000000' });
+        const ctx = makeContext({
+            usdPrice: 100,
+            avgIncomingUsd: 500,
+            amountMultiplier: 10,
+            decimals: 9,
+        });
+        expect(rule.check(tx, ctx)).toBe(false);
+    });
+});
+//# sourceMappingURL=safety-rules.test.js.map

package/dist/services/incoming/__tests__/safety-rules.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-rules.test.js","sourceRoot":"","sources":["../../../../src/services/incoming/__tests__/safety-rules.test.ts"],"names":[],"mappings":"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"}

package/dist/services/incoming/__tests__/subscription-multiplexer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subscription-multiplexer.test.d.ts.map

package/dist/services/incoming/__tests__/subscription-multiplexer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-multiplexer.test.d.ts","sourceRoot":"","sources":["../../../../src/services/incoming/__tests__/subscription-multiplexer.test.ts"],"names":[],"mappings":""}