@openora/core 0.4.1-canary.16 → 0.4.1-canary.160

package/dist/wallet/__tests__/settlement-network.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { resolveWithdrawalNetwork, assertAboveMinimumWithdrawal, AmbiguousNetworkError, UnsupportedNetworkError, WithdrawalDisabledError, BelowMinimumWithdrawalError, } from '../service/wallet.service.js';
+const asset = (network, minWithdrawal = '0', withdrawalEnabled = true) => ({
+    network,
+    minWithdrawal,
+    withdrawalEnabled,
+});
+describe('resolveWithdrawalNetwork', () => {
+    it('passes the caller through when the currency has no catalog rows', () => {
+        expect(resolveWithdrawalNetwork([], 'USD', undefined)).toBeNull();
+        expect(resolveWithdrawalNetwork([], 'USD', 'sepa')).toBe('SEPA');
+    });
+    it('implies the only payable network', () => {
+        expect(resolveWithdrawalNetwork([asset('ERC20')], 'USDT')).toBe('ERC20');
+    });
+    it('demands a network when several are payable', () => {
+        expect(() => resolveWithdrawalNetwork([asset('ERC20'), asset('TRC20')], 'USDT')).toThrow(AmbiguousNetworkError);
+    });
+    it('implies the only network still payable when the others are disabled', () => {
+        const assets = [asset('ERC20'), asset('TRC20', '0', false)];
+        expect(resolveWithdrawalNetwork(assets, 'USDT')).toBe('ERC20');
+    });
+    it('accepts an explicitly chosen payable network, normalizing case', () => {
+        const assets = [asset('ERC20'), asset('TRC20')];
+        expect(resolveWithdrawalNetwork(assets, 'USDT', 'trc20')).toBe('TRC20');
+    });
+    it('rejects a network the currency does not settle on', () => {
+        expect(() => resolveWithdrawalNetwork([asset('ERC20')], 'USDT', 'BEP20')).toThrow(UnsupportedNetworkError);
+    });
+    it('rejects a network configured but disabled for withdrawal', () => {
+        const assets = [asset('ERC20'), asset('TRC20', '0', false)];
+        expect(() => resolveWithdrawalNetwork(assets, 'USDT', 'TRC20')).toThrow(UnsupportedNetworkError);
+    });
+    it('fails closed when the currency is configured but payable nowhere', () => {
+        const assets = [asset('ERC20', '0', false), asset('TRC20', '0', false)];
+        expect(() => resolveWithdrawalNetwork(assets, 'USDT')).toThrow(WithdrawalDisabledError);
+        expect(() => resolveWithdrawalNetwork(assets, 'USDT', 'ERC20')).toThrow(WithdrawalDisabledError);
+    });
+});
+describe('assertAboveMinimumWithdrawal', () => {
+    const assets = [asset('ERC20', '20'), asset('BEP20', '1')];
+    it('enforces the floor of the chosen chain, not the currency', () => {
+        expect(() => assertAboveMinimumWithdrawal(assets, '5', 'USDT', 'ERC20')).toThrow(BelowMinimumWithdrawalError);
+        expect(() => assertAboveMinimumWithdrawal(assets, '5', 'USDT', 'BEP20')).not.toThrow();
+    });
+    it('allows an amount exactly at the floor', () => {
+        expect(() => assertAboveMinimumWithdrawal(assets, '20', 'USDT', 'ERC20')).not.toThrow();
+    });
+    it('is a no-op when the network has no catalog row', () => {
+        expect(() => assertAboveMinimumWithdrawal(assets, '0.01', 'USDT', 'TRC20')).not.toThrow();
+        expect(() => assertAboveMinimumWithdrawal([], '0.01', 'USD', null)).not.toThrow();
+    });
+});
+//# sourceMappingURL=settlement-network.test.js.map

package/dist/wallet/__tests__/settlement-network.test.js.map

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

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

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

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

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

package/dist/wallet/__tests__/swap.service.int.test.js

@@ -0,0 +1,398 @@
+import { randomUUID } from 'node:crypto';
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from 'vitest';
+import { eq, sql } from 'drizzle-orm';
+import { call } from '@orpc/server';
+import { findOneOrThrow } from '@openora/core/server';
+import { queue } from '@openora/core/contracts';
+import { createTestDb } from '@openora/core/testing';
+import { mock, makeAdminGuard, makeAuditWriter, makeEventBus, makeIdentityReader, makeJobQueue, makePaymentProviderRegistry, makeRealtimeTransport, testContext, } from '../../testing/mock.js';
+import { createWalletRouter } from '../router/index.js';
+import { migrate } from '../migrate.js';
+import { wallet, walletBalance, walletBonusCredit, walletTransaction } from '../schema/index.js';
+import { BonusRolloverLockedError, IdempotencyKeyReuseError, InsufficientBalanceError, WalletService, } from '../service/wallet.service.js';
+import { SwapFillAmountMissingError, SwapPairUnsupportedError, SwapService, } from '../service/swap.service.js';
+let db;
+const QUOTE = {
+    quoteId: 'q1',
+    fromCurrency: 'USD',
+    toCurrency: 'BTC',
+    fromAmount: '100',
+    toAmount: '0.00152',
+    rate: '0.0000153',
+    fee: '0.0000153',
+    feeCurrency: 'BTC',
+    asOf: '2026-01-01T00:00:00.000Z',
+    expiresAt: '2026-01-01T00:15:00.000Z',
+};
+function makeAdapter(overrides = {}) {
+    return mock({
+        getQuote: vi.fn().mockResolvedValue(QUOTE),
+        execute: vi
+            .fn()
+            .mockResolvedValue({ externalId: 'ext-1', status: 'completed', toAmount: '0.00152' }),
+        ...overrides,
+    });
+}
+function makeService(adapter = makeAdapter(), events = makeEventBus(), audit = makeAuditWriter()) {
+    return new SwapService({ drizzle: db.drizzle, events, adapter, audit });
+}
+// The swap routes over a real DB and a real SwapService: the money path is only proven
+// once a request reaches the ledger and the response comes back off the committed rows.
+function routerWith(swap) {
+    return createWalletRouter({
+        wallet: new WalletService({
+            drizzle: db.drizzle,
+            events: makeEventBus(),
+            payment: mock({}),
+            paymentProviders: makePaymentProviderRegistry(),
+            audit: makeAuditWriter(),
+            identityReader: makeIdentityReader(),
+        }),
+        swap,
+        adminGuard: makeAdminGuard({ caller: { userId: randomUUID(), role: 'admin' } }),
+        audit: makeAuditWriter(),
+        paymentProviders: makePaymentProviderRegistry(),
+        reconciliation: mock({}),
+        jobQueue: makeJobQueue(),
+        reconciliationQueue: queue('wallet-reconciliation'),
+        realtime: makeRealtimeTransport(),
+    });
+}
+async function seedWallet(balances = { USD: '100' }) {
+    const row = findOneOrThrow(await db.drizzle.db
+        .insert(wallet)
+        .values({ userId: randomUUID(), currency: 'USD' })
+        .returning(), new Error('seedWallet: query returned no row'));
+    for (const [currency, amount] of Object.entries(balances)) {
+        await db.drizzle.db.insert(walletBalance).values({ walletId: row.id, currency, amount });
+    }
+    return row;
+}
+async function balancesOf(walletId) {
+    const rows = await db.drizzle.db
+        .select({ currency: walletBalance.currency, amount: walletBalance.amount })
+        .from(walletBalance)
+        .where(eq(walletBalance.walletId, walletId));
+    return Object.fromEntries(rows.map((r) => [r.currency, Number(r.amount)]));
+}
+async function legs(walletId) {
+    const rows = await db.drizzle.db
+        .select()
+        .from(walletTransaction)
+        .where(eq(walletTransaction.walletId, walletId));
+    return rows.map((r) => ({
+        type: r.type,
+        amount: Number(r.amount),
+        currency: r.currency,
+        status: r.status,
+        direction: r.direction,
+    }));
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${walletTransaction}, ${walletBonusCredit}, ${walletBalance}, ${wallet} RESTART IDENTITY CASCADE`);
+});
+describe('SwapService (real PG)', () => {
+    it('prices a pair through the bound desk', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter();
+        await expect(makeService(adapter).quote({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+        })).resolves.toMatchObject({ toAmount: '0.00152' });
+    });
+    it('refuses to price a pair the desk does not make', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter({ supportsPair: vi.fn().mockReturnValue(false) });
+        await expect(makeService(adapter).quote({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+        })).rejects.toBeInstanceOf(SwapPairUnsupportedError);
+    });
+    it('books both legs and moves both balances on a filled swap', async () => {
+        const w = await seedWallet();
+        const events = makeEventBus();
+        const result = await makeService(makeAdapter(), events).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        });
+        expect(result).toMatchObject({ status: 'completed', toAmount: '0.00152' });
+        expect(await balancesOf(w.id)).toEqual({ USD: 0, BTC: 0.00152 });
+        expect(await legs(w.id)).toEqual(expect.arrayContaining([
+            expect.objectContaining({
+                type: 'swap_out',
+                currency: 'USD',
+                status: 'completed',
+                direction: 'debit',
+            }),
+            expect.objectContaining({
+                type: 'swap_in',
+                currency: 'BTC',
+                status: 'completed',
+                direction: 'credit',
+            }),
+        ]));
+        expect(events.emit).toHaveBeenCalledWith('wallet.swap.completed', expect.objectContaining({ userId: w.userId, toCurrency: 'BTC', toAmount: '0.00152' }));
+    });
+    it('credits the filled amount, never the quoted one', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter({
+            execute: vi
+                .fn()
+                .mockResolvedValue({ externalId: 'ext-2', status: 'completed', toAmount: '0.001' }),
+        });
+        await makeService(adapter).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        });
+        expect(await balancesOf(w.id)).toEqual({ USD: 0, BTC: 0.001 });
+    });
+    it('holds the funds before the vendor is called and returns them when it refuses', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter({
+            execute: vi.fn().mockImplementation(async () => {
+                // Mid-flight: the hold must already be committed and the balance gone.
+                expect(await balancesOf(w.id)).toEqual({ USD: 0 });
+                throw new Error('desk unavailable');
+            }),
+        });
+        await expect(makeService(adapter).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        })).rejects.toThrow('desk unavailable');
+        expect(await balancesOf(w.id)).toEqual({ USD: 100 });
+        expect(await legs(w.id)).toEqual([
+            expect.objectContaining({ type: 'swap_out', status: 'failed' }),
+        ]);
+    });
+    it('refuses a swap the balance cannot cover, without writing a hold', async () => {
+        const w = await seedWallet({ USD: '10' });
+        const adapter = makeAdapter();
+        await expect(makeService(adapter).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        })).rejects.toBeInstanceOf(InsufficientBalanceError);
+        expect(adapter.execute).not.toHaveBeenCalled();
+        expect(await legs(w.id)).toEqual([]);
+        expect(await balancesOf(w.id)).toEqual({ USD: 10 });
+    });
+    it('names the bonus rollover, not a missing balance, when locked funds block the swap', async () => {
+        const w = await seedWallet();
+        await db.drizzle.db.insert(walletBonusCredit).values({
+            walletId: w.id,
+            userId: w.userId,
+            currency: 'USD',
+            sourceType: 'gift',
+            creditedAmount: '100',
+            rolloverMultiplier: '1',
+            rolloverRequired: '100',
+            rolloverProgress: '0',
+            status: 'active',
+        });
+        const adapter = makeAdapter();
+        await expect(makeService(adapter).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        })).rejects.toBeInstanceOf(BonusRolloverLockedError);
+        expect(adapter.execute).not.toHaveBeenCalled();
+        expect(await balancesOf(w.id)).toEqual({ USD: 100 });
+    });
+    it('trades once for a replayed idempotency key', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter();
+        const svc = makeService(adapter);
+        const idempotencyKey = randomUUID();
+        const args = {
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey,
+        };
+        await svc.swap(args);
+        const replay = await svc.swap(args);
+        expect(replay.status).toBe('completed');
+        expect(adapter.execute).toHaveBeenCalledOnce();
+        expect(await balancesOf(w.id)).toEqual({ USD: 0, BTC: 0.00152 });
+    });
+    it('refuses a replayed key whose amount differs past float precision', async () => {
+        const w = await seedWallet({ USD: '200' });
+        const svc = makeService();
+        const idempotencyKey = randomUUID();
+        const args = { userId: w.userId, fromCurrency: 'USD', toCurrency: 'BTC', idempotencyKey };
+        await svc.swap({ ...args, fromAmount: '100' });
+        await expect(svc.swap({ ...args, fromAmount: '100.000000000000000001' })).rejects.toBeInstanceOf(IdempotencyKeyReuseError);
+    });
+    it('hands the desk the player on quote and execute, so a quote can be bound to them', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter();
+        const svc = makeService(adapter);
+        const input = { userId: w.userId, fromCurrency: 'USD', toCurrency: 'BTC', fromAmount: '100' };
+        await svc.quote(input);
+        await svc.swap({ ...input, idempotencyKey: randomUUID() });
+        expect(adapter.getQuote).toHaveBeenCalledWith(expect.objectContaining({ userId: w.userId }));
+        expect(adapter.execute).toHaveBeenCalledWith(expect.objectContaining({ userId: w.userId }));
+    });
+    it('writes the settled swap to the audit trail with the ledger rows', async () => {
+        const w = await seedWallet();
+        const audit = makeAuditWriter();
+        const result = await makeService(makeAdapter(), makeEventBus(), audit).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        });
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+            action: 'wallet.swap.completed',
+            resourceId: result.transactionId,
+            after: expect.objectContaining({ userId: w.userId, toAmount: '0.00152' }),
+        }));
+    });
+    it('writes a refund to the audit trail when the desk refuses', async () => {
+        const w = await seedWallet();
+        const audit = makeAuditWriter();
+        const adapter = makeAdapter({ execute: vi.fn().mockRejectedValue(new Error('desk down')) });
+        await expect(makeService(adapter, makeEventBus(), audit).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        })).rejects.toThrow('desk down');
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ action: 'wallet.swap.refunded' }));
+        expect(await balancesOf(w.id)).toEqual({ USD: 100 });
+    });
+    it('never credits a fill amount that is not a money value, and says so in the audit trail', async () => {
+        const w = await seedWallet();
+        const audit = makeAuditWriter();
+        const adapter = makeAdapter({
+            execute: vi
+                .fn()
+                .mockResolvedValue({ externalId: 'ext-bad', status: 'completed', toAmount: 'NaN' }),
+        });
+        const result = makeService(adapter, makeEventBus(), audit).swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        });
+        await expect(result).rejects.toBeInstanceOf(SwapFillAmountMissingError);
+        expect(await balancesOf(w.id)).toEqual({ USD: 0 });
+        expect(await legs(w.id)).toEqual([
+            expect.objectContaining({ type: 'swap_out', status: 'processing' }),
+        ]);
+        expect(audit.record).toHaveBeenCalledWith(expect.objectContaining({
+            action: 'wallet.swap.fill_rejected',
+            after: expect.objectContaining({ externalId: 'ext-bad', toAmount: 'NaN' }),
+        }));
+    });
+    it('runs a swap end to end over the route: request, ledger rows, audit row, response', async () => {
+        const w = await seedWallet();
+        const audit = makeAuditWriter();
+        const router = routerWith(makeService(makeAdapter(), makeEventBus(), audit));
+        const result = await call(router.swap.execute, {
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        }, { context: testContext({ auth: { userId: w.userId } }) });
+        expect(result).toMatchObject({ status: 'completed', toAmount: '0.00152' });
+        expect(await balancesOf(w.id)).toEqual({ USD: 0, BTC: 0.00152 });
+        expect(await legs(w.id)).toHaveLength(2);
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+            action: 'wallet.swap.completed',
+            resourceId: result.transactionId,
+            after: expect.objectContaining({ userId: w.userId }),
+        }));
+    });
+    it('leaves an async fill processing until the vendor webhook settles it', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter({
+            execute: vi.fn().mockResolvedValue({ externalId: 'ext-3', status: 'processing' }),
+        });
+        const svc = makeService(adapter);
+        const result = await svc.swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        });
+        expect(result).toMatchObject({ status: 'processing', toAmount: null });
+        expect(await balancesOf(w.id)).toEqual({ USD: 0 });
+        await svc.reconcileSwapStatus({
+            kind: 'swap',
+            externalId: 'ext-3',
+            status: 'completed',
+            toAmount: '0.0014',
+        });
+        expect(await balancesOf(w.id)).toEqual({ USD: 0, BTC: 0.0014 });
+        // A duplicate delivery must not credit the fill twice.
+        await svc.reconcileSwapStatus({
+            kind: 'swap',
+            externalId: 'ext-3',
+            status: 'completed',
+            toAmount: '0.0014',
+        });
+        expect(await balancesOf(w.id)).toEqual({ USD: 0, BTC: 0.0014 });
+    });
+    it('returns the held funds when the vendor reports the swap failed', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter({
+            execute: vi.fn().mockResolvedValue({ externalId: 'ext-4', status: 'processing' }),
+        });
+        const svc = makeService(adapter);
+        await svc.swap({
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        });
+        await svc.reconcileSwapStatus({ kind: 'swap', externalId: 'ext-4', status: 'failed' });
+        expect(await balancesOf(w.id)).toEqual({ USD: 100 });
+        expect(await legs(w.id)).toEqual([
+            expect.objectContaining({ type: 'swap_out', status: 'failed' }),
+        ]);
+    });
+    it('refuses a pair the vendor does not make and a swap into the same currency', async () => {
+        const w = await seedWallet();
+        const adapter = makeAdapter({ supportsPair: vi.fn().mockReturnValue(false) });
+        const args = {
+            userId: w.userId,
+            fromCurrency: 'USD',
+            toCurrency: 'BTC',
+            fromAmount: '100',
+            idempotencyKey: randomUUID(),
+        };
+        await expect(makeService(adapter).swap(args)).rejects.toBeInstanceOf(SwapPairUnsupportedError);
+        await expect(makeService().swap({ ...args, toCurrency: 'usd' })).rejects.toBeInstanceOf(SwapPairUnsupportedError);
+    });
+});
+//# sourceMappingURL=swap.service.int.test.js.map

package/dist/wallet/__tests__/swap.service.int.test.js.map

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

package/dist/wallet/__tests__/wallet-address-format.test.d.ts

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

package/dist/wallet/__tests__/wallet-address-format.test.d.ts.map

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

package/dist/wallet/__tests__/wallet-address-format.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from 'vitest';
+import { isWalletAddressValidForNetwork, CreateWithdrawalAddressInputSchema, WithdrawInputSchema, } from '../contract/index.js';
+const VALID_BY_NETWORK = {
+    SEGWIT: 'bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4',
+    BITCOIN_CASH: 'qpm2qsznhks23z7629mms6s4cwef74vcwvy22gdx6a',
+    LITECOIN: 'ltc1qw508d6qejxtdg4y5r3zarvary0c5xw7k7grplx',
+    DOGECOIN: 'DBXu2kgc3xtvCUWFcxFE3r9hEYgmuaaCyD',
+    XRP_LEDGER: 'rEb8TK3gBgk5auZkwc6sHnwrGVJH8DuaLh',
+    ERC20: '0x1111111111111111111111111111111111111111',
+    BEP20: '0x1111111111111111111111111111111111111111',
+    TRC20: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
+    SOLANA: '5FHwkrdxSFrHm2h8hZvfF3TN3zCz6E5uH3xYFecKC2Sy',
+};
+const INVALID_BY_NETWORK = {
+    SEGWIT: 'not-a-valid-address',
+    BITCOIN_CASH: 'not-a-valid-address',
+    LITECOIN: 'not-a-valid-address',
+    DOGECOIN: 'not-a-valid-address',
+    XRP_LEDGER: 'not-a-valid-address',
+    ERC20: 'not-a-valid-address-zzzz',
+    BEP20: 'not-a-valid-address-zzzz',
+    TRC20: 'not-a-valid-address',
+    SOLANA: 'not!!avalid00000',
+};
+describe('isWalletAddressValidForNetwork', () => {
+    for (const [network, address] of Object.entries(VALID_BY_NETWORK)) {
+        it(`accepts a well-formed ${network} address`, () => {
+            expect(isWalletAddressValidForNetwork(address, network)).toBe(true);
+        });
+    }
+    for (const [network, address] of Object.entries(INVALID_BY_NETWORK)) {
+        it(`rejects a malformed ${network} address`, () => {
+            expect(isWalletAddressValidForNetwork(address, network)).toBe(false);
+        });
+    }
+    it('looks the pattern up case-insensitively by network', () => {
+        expect(isWalletAddressValidForNetwork(VALID_BY_NETWORK['ERC20'], 'erc20')).toBe(true);
+    });
+    it('accepts any well-formed string for a network with no entry in the table - an operator can add a chain core has never heard of', () => {
+        expect(isWalletAddressValidForNetwork('some-brand-new-chain-address', 'RIPPLENET')).toBe(true);
+        expect(isWalletAddressValidForNetwork('short', 'RIPPLENET')).toBe(false);
+    });
+    it('does not trim or change case - callers own that', () => {
+        const padded = `  ${VALID_BY_NETWORK['ERC20']}  `;
+        expect(isWalletAddressValidForNetwork(padded, 'ERC20')).toBe(false);
+        const lower = VALID_BY_NETWORK['TRC20'].toLowerCase();
+        expect(isWalletAddressValidForNetwork(lower, 'TRC20')).toBe(false);
+    });
+});
+describe('CreateWithdrawalAddressInputSchema network/address cross-check', () => {
+    it('rejects a mismatched network/address pair on the address field', () => {
+        const result = CreateWithdrawalAddressInputSchema.safeParse({
+            label: 'Ledger',
+            currency: 'BTC',
+            network: 'SEGWIT',
+            address: INVALID_BY_NETWORK['SEGWIT'],
+        });
+        expect(result.success).toBe(false);
+        expect(result.error?.issues[0]?.path).toEqual(['address']);
+    });
+    it('trims before checking the format, so a pasted address with stray whitespace still validates', () => {
+        const result = CreateWithdrawalAddressInputSchema.safeParse({
+            label: 'Ledger',
+            currency: 'USDT',
+            network: 'ERC20',
+            address: `  ${VALID_BY_NETWORK['ERC20']}  `,
+        });
+        expect(result.success).toBe(true);
+    });
+});
+describe('WithdrawInputSchema network/destinationAddress cross-check', () => {
+    it('rejects a mismatched network/address pair on the destinationAddress field', () => {
+        const result = WithdrawInputSchema.safeParse({
+            amount: '10',
+            currency: 'BTC',
+            network: 'SEGWIT',
+            idempotencyKey: '9a2f7c11-0000-4000-8000-00000000a001',
+            destinationAddress: INVALID_BY_NETWORK['SEGWIT'],
+        });
+        expect(result.success).toBe(false);
+        expect(result.error?.issues[0]?.path).toEqual(['destinationAddress']);
+    });
+    it('skips the check when network is absent - a single-chain currency has none to check against', () => {
+        const result = WithdrawInputSchema.safeParse({
+            amount: '10',
+            currency: 'BTC',
+            idempotencyKey: '9a2f7c11-0000-4000-8000-00000000a001',
+            destinationAddress: 'anything-well-formed-enough',
+        });
+        expect(result.success).toBe(true);
+    });
+    it('skips the check when destinationAddress is absent', () => {
+        const result = WithdrawInputSchema.safeParse({
+            amount: '10',
+            currency: 'BTC',
+            network: 'SEGWIT',
+            idempotencyKey: '9a2f7c11-0000-4000-8000-00000000a001',
+        });
+        expect(result.success).toBe(true);
+    });
+});
+//# sourceMappingURL=wallet-address-format.test.js.map

package/dist/wallet/__tests__/wallet-address-format.test.js.map

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

package/dist/wallet/__tests__/wallet-asset.router.int.test.d.ts

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

package/dist/wallet/__tests__/wallet-asset.router.int.test.d.ts.map

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