@t2000/sdk 0.17.21 → 0.17.23

package/dist/gas/manager.test.js

@@ -0,0 +1,220 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { Transaction } from '@mysten/sui/transactions';
+import { T2000Error } from '../errors.js';
+// Mock all external dependencies before importing the module under test
+vi.mock('./autoTopUp.js', () => ({
+    shouldAutoTopUp: vi.fn(),
+    executeAutoTopUp: vi.fn(),
+}));
+vi.mock('./gasStation.js', () => ({
+    requestGasSponsorship: vi.fn(),
+    reportGasUsage: vi.fn(),
+}));
+// Import after mocks are set up
+import { executeWithGas } from './manager.js';
+import { shouldAutoTopUp, executeAutoTopUp } from './autoTopUp.js';
+import { requestGasSponsorship } from './gasStation.js';
+const MOCK_DIGEST = 'MockTxDigest123456789';
+const MOCK_EFFECTS = {
+    gasUsed: {
+        computationCost: '1000000',
+        storageCost: '2000000',
+        storageRebate: '500000',
+    },
+};
+function mockClient(suiBalance) {
+    return {
+        getBalance: vi.fn().mockResolvedValue({ totalBalance: suiBalance.toString() }),
+        signAndExecuteTransaction: vi.fn().mockResolvedValue({
+            digest: MOCK_DIGEST,
+            effects: MOCK_EFFECTS,
+        }),
+        executeTransactionBlock: vi.fn().mockResolvedValue({
+            digest: MOCK_DIGEST,
+            effects: MOCK_EFFECTS,
+        }),
+        waitForTransaction: vi.fn().mockResolvedValue({}),
+    };
+}
+function mockKeypair() {
+    return {
+        getPublicKey: () => ({
+            toSuiAddress: () => '0x' + 'a'.repeat(64),
+        }),
+        signTransaction: vi.fn().mockResolvedValue({ signature: 'mock-sig' }),
+    };
+}
+function buildTx() {
+    const tx = new Transaction();
+    return tx;
+}
+describe('executeWithGas', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('Step 1: Self-funded', () => {
+        it('uses self-funded when SUI balance >= 0.05', async () => {
+            const client = mockClient(100000000n); // 0.1 SUI
+            const keypair = mockKeypair();
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            expect(result.gasMethod).toBe('self-funded');
+            expect(result.digest).toBe(MOCK_DIGEST);
+            expect(result.gasCostSui).toBeGreaterThan(0);
+        });
+        it('skips self-funded when SUI balance < 0.05', async () => {
+            const client = mockClient(1000000n); // 0.001 SUI — too low
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(true);
+            vi.mocked(executeAutoTopUp).mockResolvedValue({
+                success: true,
+                tx: 'topup-digest',
+                usdcSpent: 1,
+                suiReceived: 0.3,
+            });
+            // After topup, balance check will still use the mock that returns low balance
+            // but the second signAndExecuteTransaction call will succeed
+            // We need the getBalance mock to return enough after topup
+            const balanceMock = vi.fn()
+                .mockResolvedValueOnce({ totalBalance: '1000000' }) // Step 1: too low
+                .mockResolvedValueOnce({ totalBalance: '1000000' }) // shouldAutoTopUp check
+                .mockResolvedValueOnce({ totalBalance: '1000000' }) // shouldAutoTopUp check (USDC)
+                .mockResolvedValueOnce({ totalBalance: '100000000' }); // Step 2: after topup, enough
+            client.getBalance = balanceMock;
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            expect(result.gasMethod).toBe('auto-topup');
+        });
+    });
+    describe('Step 2: Auto-topup', () => {
+        it('swaps USDC→SUI then executes self-funded', async () => {
+            const client = mockClient(1000000n); // low SUI
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(true);
+            vi.mocked(executeAutoTopUp).mockResolvedValue({
+                success: true,
+                tx: 'topup-digest',
+                usdcSpent: 1,
+                suiReceived: 0.3,
+            });
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            expect(vi.mocked(executeAutoTopUp)).toHaveBeenCalledOnce();
+            expect(result.gasMethod).toBe('auto-topup');
+            expect(result.digest).toBe(MOCK_DIGEST);
+        });
+        it('falls through to sponsored when auto-topup fails', async () => {
+            const client = mockClient(1000000n); // low SUI
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(true);
+            vi.mocked(executeAutoTopUp).mockRejectedValue(new Error('auto-topup failed'));
+            // Setup sponsored path
+            vi.mocked(requestGasSponsorship).mockResolvedValue({
+                txBytes: Buffer.from('mock-tx').toString('base64'),
+                sponsorSignature: 'mock-sponsor-sig',
+                type: 'fallback',
+            });
+            // buildTx for sponsored path calls tx.build() which needs client
+            // We mock the sponsored path to succeed
+            const buildSpy = vi.spyOn(Transaction.prototype, 'build')
+                .mockResolvedValue(new Uint8Array([1, 2, 3]));
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            expect(result.gasMethod).toBe('sponsored');
+            buildSpy.mockRestore();
+        });
+        it('skips auto-topup when shouldAutoTopUp returns false', async () => {
+            const client = mockClient(1000000n); // low SUI
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(false);
+            // Sponsored path
+            vi.mocked(requestGasSponsorship).mockResolvedValue({
+                txBytes: Buffer.from('mock-tx').toString('base64'),
+                sponsorSignature: 'mock-sponsor-sig',
+                type: 'fallback',
+            });
+            const buildSpy = vi.spyOn(Transaction.prototype, 'build')
+                .mockResolvedValue(new Uint8Array([1, 2, 3]));
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            expect(vi.mocked(executeAutoTopUp)).not.toHaveBeenCalled();
+            expect(result.gasMethod).toBe('sponsored');
+            buildSpy.mockRestore();
+        });
+    });
+    describe('Step 3: Sponsored', () => {
+        it('uses gas station when self-funded and auto-topup both fail', async () => {
+            const client = mockClient(1000000n); // low SUI
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(false);
+            vi.mocked(requestGasSponsorship).mockResolvedValue({
+                txBytes: Buffer.from('mock-tx').toString('base64'),
+                sponsorSignature: 'mock-sponsor-sig',
+                type: 'fallback',
+            });
+            const buildSpy = vi.spyOn(Transaction.prototype, 'build')
+                .mockResolvedValue(new Uint8Array([1, 2, 3]));
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            expect(result.gasMethod).toBe('sponsored');
+            expect(vi.mocked(requestGasSponsorship)).toHaveBeenCalledOnce();
+            buildSpy.mockRestore();
+        });
+    });
+    describe('Step 4: All methods exhausted', () => {
+        it('throws INSUFFICIENT_GAS when all methods fail', async () => {
+            const client = mockClient(1000000n); // low SUI
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(false);
+            vi.mocked(requestGasSponsorship).mockRejectedValue(new Error('gas station down'));
+            const buildSpy = vi.spyOn(Transaction.prototype, 'build')
+                .mockResolvedValue(new Uint8Array([1, 2, 3]));
+            await expect(executeWithGas(client, keypair, () => buildTx())).rejects.toThrow('No SUI for gas');
+            buildSpy.mockRestore();
+        });
+        it('error has correct code', async () => {
+            const client = mockClient(1000000n);
+            const keypair = mockKeypair();
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(false);
+            vi.mocked(requestGasSponsorship).mockRejectedValue(new Error('down'));
+            const buildSpy = vi.spyOn(Transaction.prototype, 'build')
+                .mockResolvedValue(new Uint8Array([1, 2, 3]));
+            try {
+                await executeWithGas(client, keypair, () => buildTx());
+                expect.unreachable('should have thrown');
+            }
+            catch (err) {
+                expect(err).toBeInstanceOf(T2000Error);
+                expect(err.code).toBe('INSUFFICIENT_GAS');
+            }
+            buildSpy.mockRestore();
+        });
+    });
+    describe('buildTx callback', () => {
+        it('calls buildTx fresh for each gas strategy attempt', async () => {
+            const client = mockClient(1000000n); // low SUI — skip step 1
+            const keypair = mockKeypair();
+            let buildCount = 0;
+            vi.mocked(shouldAutoTopUp).mockResolvedValue(false);
+            vi.mocked(requestGasSponsorship).mockResolvedValue({
+                txBytes: Buffer.from('mock-tx').toString('base64'),
+                sponsorSignature: 'mock-sponsor-sig',
+                type: 'fallback',
+            });
+            const buildSpy = vi.spyOn(Transaction.prototype, 'build')
+                .mockResolvedValue(new Uint8Array([1, 2, 3]));
+            await executeWithGas(client, keypair, () => {
+                buildCount++;
+                return buildTx();
+            });
+            // Called once for step 1 (fails), once for step 2 (skipped via shouldAutoTopUp=false),
+            // once for step 3 (sponsored succeeds)
+            expect(buildCount).toBeGreaterThanOrEqual(2);
+            buildSpy.mockRestore();
+        });
+    });
+    describe('extractGasCost', () => {
+        it('correctly calculates gas cost from effects', async () => {
+            const client = mockClient(100000000n);
+            const keypair = mockKeypair();
+            const result = await executeWithGas(client, keypair, () => buildTx());
+            // (1000000 + 2000000 - 500000) / 1e9 = 0.0025
+            expect(result.gasCostSui).toBeCloseTo(0.0025, 6);
+        });
+    });
+});
+//# sourceMappingURL=manager.test.js.map

package/dist/gas/manager.test.js.map

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

package/dist/gas/serialization.test.d.ts

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

package/dist/gas/serialization.test.d.ts.map

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

package/dist/gas/serialization.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from 'vitest';
+import { Transaction } from '@mysten/sui/transactions';
+describe('Transaction serialization roundtrip', () => {
+    it('serialize() returns a JSON string (not bytes)', () => {
+        const tx = new Transaction();
+        tx.setSender('0x' + 'a'.repeat(64));
+        const serialized = tx.serialize();
+        expect(typeof serialized).toBe('string');
+        expect(() => JSON.parse(serialized)).not.toThrow();
+    });
+    it('Transaction.from(jsonString) reconstructs from serialize()', () => {
+        const tx = new Transaction();
+        tx.setSender('0x' + 'a'.repeat(64));
+        const serialized = tx.serialize();
+        const restored = Transaction.from(serialized);
+        expect(restored).toBeInstanceOf(Transaction);
+    });
+    it('roundtrip preserves sender', () => {
+        const address = '0x' + 'b'.repeat(64);
+        const tx = new Transaction();
+        tx.setSender(address);
+        const serialized = tx.serialize();
+        const restored = Transaction.from(serialized);
+        const reserialized = restored.serialize();
+        expect(JSON.parse(reserialized).sender).toBe(address);
+    });
+    it('Transaction.from(Buffer) treats input as BCS (NOT JSON)', () => {
+        const tx = new Transaction();
+        tx.setSender('0x' + 'a'.repeat(64));
+        const serialized = tx.serialize();
+        // Passing a Buffer (Uint8Array) makes Transaction.from try BCS deserialization
+        // which fails because JSON bytes aren't valid BCS — this is the bug we fixed
+        const buf = Buffer.from(serialized);
+        expect(() => Transaction.from(buf)).toThrow();
+    });
+    it('tx.serialize() is safe to embed in JSON request body', () => {
+        const tx = new Transaction();
+        tx.setSender('0x' + 'c'.repeat(64));
+        const serialized = tx.serialize();
+        const requestBody = JSON.stringify({ txJson: serialized, sender: '0x' + 'c'.repeat(64) });
+        const parsed = JSON.parse(requestBody);
+        expect(typeof parsed.txJson).toBe('string');
+        const restored = Transaction.from(parsed.txJson);
+        expect(restored).toBeInstanceOf(Transaction);
+    });
+});
+//# sourceMappingURL=serialization.test.js.map

package/dist/gas/serialization.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.test.js","sourceRoot":"","sources":["../../src/gas/serialization.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAElC,+EAA+E;QAC/E,6EAA6E;QAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAEvC,MAAM,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}