@openora/core 0.4.1-canary.93 → 0.4.1-canary.95

package/dist/wallet/__tests__/custody-sweep.service.int.test.js

@@ -0,0 +1,246 @@
+import { randomUUID } from 'node:crypto';
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from 'vitest';
+import { eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { definePlatformConfig, } from '@openora/core/contracts';
+import { makeAuditWriter, makePaymentProviderRegistry, mock } from '../../testing/mock.js';
+import { migrate } from '../migrate.js';
+import { wallet, walletAsset, walletBalance, walletCustodySweep, walletJobRun, walletReconciliationFinding, walletTransaction, } from '../schema/index.js';
+import { CustodySweepService, CUSTODY_SWEEP_JOB_NAME } from '../service/custody-sweep.service.js';
+let db;
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${walletReconciliationFinding}, ${walletCustodySweep}, ${walletJobRun}, ${walletAsset}, ${walletTransaction}, ${walletBalance}, ${wallet} RESTART IDENTITY CASCADE`);
+});
+const platformConfig = (overrides = {}) => definePlatformConfig({
+    wallet: {
+        sweep: {
+            cron: '*/15 * * * *',
+            feeMultiple: '1',
+            batchSize: 200,
+            concurrency: 4,
+            unknownAfterMinutes: 60,
+            staleRunAfterMinutes: 30,
+            ...overrides,
+        },
+    },
+});
+async function seedAsset(overrides = {}) {
+    await db.drizzle.db.insert(walletAsset).values({
+        currency: 'USDT',
+        network: 'TRC20',
+        providerAssetId: 'usdt-trc20',
+        minDeposit: '1',
+        minWithdrawal: '1',
+        withdrawalFee: '0.1',
+        ...overrides,
+    });
+}
+function makeBalance(overrides = {}) {
+    return {
+        userId: randomUUID(),
+        currency: 'USDT',
+        network: 'TRC20',
+        amount: '100',
+        estimatedFee: '1',
+        ...overrides,
+    };
+}
+function serviceWith(adapter, config = platformConfig()) {
+    const paymentProviders = makePaymentProviderRegistry({ adapter });
+    const audit = makeAuditWriter();
+    const service = new CustodySweepService({
+        drizzle: db.drizzle,
+        paymentProviders,
+        audit,
+        platformConfig: config,
+    });
+    return { service, audit };
+}
+async function sweepRows(userId) {
+    return db.drizzle.db
+        .select()
+        .from(walletCustodySweep)
+        .where(eq(walletCustodySweep.userId, userId));
+}
+describe('CustodySweepService (real PG)', () => {
+    it('no-ops without touching the database when sweep policy is unconfigured', async () => {
+        const listSweepableBalances = vi.fn().mockResolvedValue([makeBalance()]);
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool: vi.fn() }), definePlatformConfig({}));
+        const result = await service.runCycle();
+        expect(result).toBeNull();
+        expect(listSweepableBalances).not.toHaveBeenCalled();
+        const runs = await db.drizzle.db.select().from(walletJobRun);
+        expect(runs).toHaveLength(0);
+    });
+    it('a second cycle does not re-sweep an in-flight balance', async () => {
+        await seedAsset();
+        const b = makeBalance();
+        const listSweepableBalances = vi.fn().mockResolvedValue([b]);
+        const sweepToPool = vi
+            .fn()
+            .mockResolvedValue({ externalId: 'vendor-ref-1', poolRef: 'pool-players-1' });
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool }));
+        const first = await service.runCycle();
+        expect(first?.summary.swept).toBe(1);
+        const second = await service.runCycle();
+        expect(second?.summary.swept).toBe(0);
+        expect(second?.summary.inFlight).toBe(1);
+        expect(sweepToPool).toHaveBeenCalledTimes(1);
+        const rows = await sweepRows(b.userId);
+        expect(rows).toHaveLength(1);
+        expect(rows[0]?.status).toBe('processing');
+        // Which pool received the funds, not merely that a transfer happened - the
+        // separation of player money from operator money has to be evidenced.
+        expect(rows[0]?.poolRef).toBe('pool-players-1');
+    });
+    it('sweepToPool throws -> the guard is still held and the next cycle does not re-sweep', async () => {
+        await seedAsset();
+        const b = makeBalance();
+        const listSweepableBalances = vi.fn().mockResolvedValue([b]);
+        const sweepToPool = vi.fn().mockRejectedValue(new Error('vendor timed out'));
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool }));
+        const first = await service.runCycle();
+        expect(first?.summary.unknown).toBe(1);
+        expect(first?.summary.swept).toBe(0);
+        const rowsAfterFirst = await sweepRows(b.userId);
+        expect(rowsAfterFirst).toHaveLength(1);
+        expect(rowsAfterFirst[0]?.status).toBe('unknown');
+        const second = await service.runCycle();
+        expect(second?.summary.inFlight).toBe(1);
+        expect(second?.summary.swept).toBe(0);
+        // Still exactly the one row from the first cycle - the throw never released the guard.
+        expect(sweepToPool).toHaveBeenCalledTimes(1);
+        const rowsAfterSecond = await sweepRows(b.userId);
+        expect(rowsAfterSecond).toHaveLength(1);
+        expect(rowsAfterSecond[0]?.status).toBe('unknown');
+    });
+    it('a swept balance changes no wallet_balance row and creates no wallet_transaction', async () => {
+        await seedAsset();
+        const b = makeBalance();
+        const adapter = mock({
+            listSweepableBalances: vi.fn().mockResolvedValue([b]),
+            sweepToPool: vi.fn().mockResolvedValue({ externalId: 'vendor-ref-2' }),
+        });
+        const { service } = serviceWith(adapter);
+        const result = await service.runCycle();
+        expect(result?.summary.swept).toBe(1);
+        const balances = await db.drizzle.db.select().from(walletBalance);
+        const transactions = await db.drizzle.db.select().from(walletTransaction);
+        expect(balances).toHaveLength(0);
+        expect(transactions).toHaveLength(0);
+    });
+    it('two cycles started concurrently: the second returns immediately and listSweepableBalances is called exactly once', async () => {
+        await seedAsset();
+        // The vendor call has to be slow enough to hold the first cycle's claim open while
+        // the second one attempts its own. Resolved immediately, a cycle can finish - and
+        // clear its claim - before the sibling's insert is even issued, at which point both
+        // legitimately succeed as two SEQUENTIAL runs and the test fails without anything
+        // being wrong. That is a race in the test, not in the claim.
+        const balances = [makeBalance()];
+        const listSweepableBalances = vi.fn(() => new Promise((resolve) => setTimeout(() => resolve(balances), 100)));
+        const sweepToPool = vi.fn().mockResolvedValue({ externalId: randomUUID() });
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool }));
+        const [a, b] = await Promise.all([service.runCycle(), service.runCycle()]);
+        const results = [a, b];
+        const claimed = results.filter((r) => r !== null);
+        const skipped = results.filter((r) => r === null);
+        expect(claimed).toHaveLength(1);
+        expect(skipped).toHaveLength(1);
+        expect(listSweepableBalances).toHaveBeenCalledTimes(1);
+    });
+    it('a missing wallet_asset row produces an unconfigured_asset finding', async () => {
+        // Deliberately no seedAsset() call - (currency, network) is unconfigured.
+        const b = makeBalance({ currency: 'DOGE', network: 'MAINNET' });
+        const listSweepableBalances = vi.fn().mockResolvedValue([b]);
+        const sweepToPool = vi.fn().mockResolvedValue({ externalId: 'never-called' });
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool }));
+        const result = await service.runCycle();
+        expect(result?.summary.swept).toBe(0);
+        expect(result?.summary.skippedDust).toBe(0);
+        const findings = await db.drizzle.db.select().from(walletReconciliationFinding);
+        expect(findings).toHaveLength(1);
+        expect(findings[0]).toMatchObject({
+            kind: 'unconfigured_asset',
+            currency: 'DOGE',
+            network: 'MAINNET',
+            amount: '100.000000000000000000',
+            runId: result?.runId,
+        });
+        const sweeps = await sweepRows(b.userId);
+        expect(sweeps).toHaveLength(0);
+    });
+    it('writes exactly one audit entry per cycle regardless of how many balances were swept', async () => {
+        await seedAsset();
+        const balances = [makeBalance(), makeBalance(), makeBalance()];
+        const adapter = mock({
+            listSweepableBalances: vi.fn().mockResolvedValue(balances),
+            sweepToPool: vi.fn().mockImplementation(async () => ({ externalId: randomUUID() })),
+        });
+        const { service, audit } = serviceWith(adapter);
+        const result = await service.runCycle();
+        expect(result?.summary.swept).toBe(3);
+        expect(audit.recordInTransaction).toHaveBeenCalledTimes(1);
+        const [, entry] = audit.recordInTransaction.mock.calls[0];
+        expect(entry.action).toBe('wallet.custody.sweep_cycle');
+        expect(entry.after).toMatchObject({ runId: result?.runId, swept: 3 });
+    });
+    it('a repeated unconfigured asset files exactly one finding, not one per cycle', async () => {
+        // Without a stable dedup key this condition - which recurs every single tick until
+        // an operator configures the asset - files a fresh finding per cron tick and pins
+        // the reconciliation alert threshold permanently over the line.
+        const b = makeBalance({ currency: 'DOGE', network: 'MAINNET' });
+        const listSweepableBalances = vi.fn().mockResolvedValue([b]);
+        const sweepToPool = vi.fn();
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool }));
+        await service.runCycle();
+        await service.runCycle();
+        const findings = await db.drizzle.db.select().from(walletReconciliationFinding);
+        expect(findings).toHaveLength(1);
+    });
+    it('a throwing adapter fails the run and frees the claim for the next cycle', async () => {
+        await seedAsset();
+        const listSweepableBalances = vi
+            .fn()
+            .mockRejectedValueOnce(new Error('vendor 503'))
+            .mockResolvedValue([]);
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool: vi.fn() }));
+        await expect(service.runCycle()).rejects.toThrow('vendor 503');
+        const [failed] = await db.drizzle.db
+            .select()
+            .from(walletJobRun)
+            .where(eq(walletJobRun.status, 'failed'));
+        expect(failed?.finishedAt).not.toBeNull();
+        // The whole point: a vendor blip must not hold the single live-run slot until the
+        // staleness window elapses.
+        const second = await service.runCycle();
+        expect(second).not.toBeNull();
+    });
+    it('takes over a run whose startedAt is older than the staleness threshold', async () => {
+        const staleRunId = randomUUID();
+        await db.drizzle.db.insert(walletJobRun).values({
+            jobName: CUSTODY_SWEEP_JOB_NAME,
+            runId: staleRunId,
+            startedAt: new Date(Date.now() - 2 * 60_000),
+        });
+        const listSweepableBalances = vi.fn().mockResolvedValue([]);
+        const { service } = serviceWith(mock({ listSweepableBalances, sweepToPool: vi.fn() }), platformConfig({ staleRunAfterMinutes: 1 }));
+        const result = await service.runCycle();
+        expect(result).not.toBeNull();
+        expect(result?.runId).not.toBe(staleRunId);
+        const runs = await db.drizzle.db
+            .select()
+            .from(walletJobRun)
+            .where(eq(walletJobRun.jobName, CUSTODY_SWEEP_JOB_NAME));
+        const stale = runs.find((r) => r.runId === staleRunId);
+        const fresh = runs.find((r) => r.runId === result?.runId);
+        expect(stale?.status).toBe('abandoned');
+        expect(fresh?.status).toBe('completed');
+    });
+});
+//# sourceMappingURL=custody-sweep.service.int.test.js.map

package/dist/wallet/__tests__/custody-sweep.service.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custody-sweep.service.int.test.js","sourceRoot":"","sources":["../../../src/wallet/__tests__/custody-sweep.service.int.test.ts"],"names":[],"mappings":"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"}

package/dist/wallet/__tests__/reconciliation-diff.test.d.ts

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

package/dist/wallet/__tests__/reconciliation-diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-diff.test.d.ts","sourceRoot":"","sources":["../../../src/wallet/__tests__/reconciliation-diff.test.ts"],"names":[],"mappings":""}

package/dist/wallet/__tests__/reconciliation-diff.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from 'vitest';
+import { diffDeposit } from '../service/reconciliation.service.js';
+const depositEvent = (over = {}) => ({
+    kind: 'deposit',
+    address: 'bc1qxyz',
+    amount: '1',
+    currency: 'BTC',
+    txHash: '0xabc',
+    externalId: 'vendor-ext-1',
+    ...over,
+});
+const ledgerRow = (over = {}) => ({
+    id: 'tx-1',
+    currency: 'BTC',
+    amount: '1',
+    network: null,
+    ...over,
+});
+describe('diffDeposit', () => {
+    it('flags missing_deposit when no ledger row matches the vendor event', () => {
+        expect(diffDeposit(depositEvent(), undefined)).toBe('missing_deposit');
+    });
+    it('flags currency_mismatch when the ledger row settled in a different currency', () => {
+        const event = depositEvent({ currency: 'ETH' });
+        const tx = ledgerRow({ currency: 'BTC' });
+        expect(diffDeposit(event, tx)).toBe('currency_mismatch');
+    });
+    it('flags currency_mismatch case-insensitively as a genuine mismatch, not a false positive', () => {
+        const event = depositEvent({ currency: 'btc' });
+        const tx = ledgerRow({ currency: 'BTC' });
+        expect(diffDeposit(event, tx)).toBeNull();
+    });
+    it('flags amount_mismatch when the currencies agree but the amounts differ', () => {
+        const event = depositEvent({ amount: '2' });
+        const tx = ledgerRow({ amount: '1' });
+        expect(diffDeposit(event, tx)).toBe('amount_mismatch');
+    });
+    it('never routes an amount compare through float - "1" and "1.00" reconcile exactly', () => {
+        const event = depositEvent({ amount: '1.00' });
+        const tx = ledgerRow({ amount: '1' });
+        expect(diffDeposit(event, tx)).toBeNull();
+    });
+    it('reconciles (returns null) when currency and amount both match', () => {
+        const event = depositEvent();
+        const tx = ledgerRow();
+        expect(diffDeposit(event, tx)).toBeNull();
+    });
+});
+//# sourceMappingURL=reconciliation-diff.test.js.map

package/dist/wallet/__tests__/reconciliation-diff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-diff.test.js","sourceRoot":"","sources":["../../../src/wallet/__tests__/reconciliation-diff.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE,MAAM,YAAY,GAAG,CAAC,OAAmD,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/E,IAAI,EAAE,SAAkB;IACxB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,cAAc;IAC1B,GAAG,IAAI;CACR,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAChB,OAA0F,EAAE,EAC5F,EAAE,CAAC,CAAC;IACJ,EAAE,EAAE,MAAM;IACV,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,IAAI;IACb,GAAG,IAAI;CACR,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAE1C,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAE1C,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAEtC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAEtC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAEvB,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/wallet/__tests__/reconciliation.service.int.test.d.ts

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

package/dist/wallet/__tests__/reconciliation.service.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.service.int.test.d.ts","sourceRoot":"","sources":["../../../src/wallet/__tests__/reconciliation.service.int.test.ts"],"names":[],"mappings":""}