@tangram-mover/sdk 0.1.0

package/dist/src/utils/rpc-client.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * RPC client wrapper for Sui network interactions
+ * Uses sui-kit's RPC client when available, falls back to direct RPC calls
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcClient = void 0;
+/**
+ * Wrapper around Sui RPC client
+ */
+class RpcClient {
+    constructor(suiKit, rateLimitMs = 1000) {
+        this.lastRequestTime = 0;
+        this.suiKit = suiKit;
+        this.rateLimitMs = rateLimitMs;
+    }
+    /**
+     * Get the underlying Sui client from sui-kit
+     */
+    getClient() {
+        // Access the RPC client from sui-kit
+        // sui-kit exposes the client through its internal structure
+        // Try multiple possible property names
+        const kit = this.suiKit;
+        return kit.client || kit.rpcClient || kit.suiClient || kit._client;
+    }
+    /**
+     * Rate limit helper
+     */
+    async rateLimit() {
+        const now = Date.now();
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < this.rateLimitMs) {
+            const waitTime = this.rateLimitMs - timeSinceLastRequest;
+            await new Promise(resolve => setTimeout(resolve, waitTime));
+        }
+        this.lastRequestTime = Date.now();
+    }
+    /**
+     * Fetch transaction with options
+     */
+    async getTransactionBlock(digest, options) {
+        await this.rateLimit();
+        const client = this.getClient();
+        // Use sui-kit's RPC client to fetch transaction
+        if (client && typeof client.getTransactionBlock === 'function') {
+            return await client.getTransactionBlock({
+                digest,
+                options: options || {
+                    showInput: true,
+                    showEffects: true,
+                    showEvents: true,
+                    showBalanceChanges: true,
+                    showObjectChanges: true,
+                },
+            });
+        }
+        // Fallback: use read_api if available
+        if (client && client.read_api) {
+            return await client.read_api.getTransactionBlock({
+                digest,
+                options: options || {
+                    showInput: true,
+                    showEffects: true,
+                    showEvents: true,
+                    showBalanceChanges: true,
+                    showObjectChanges: true,
+                },
+            });
+        }
+        throw new Error('Unable to access Sui RPC client from sui-kit');
+    }
+    /**
+     * Get multiple transaction blocks
+     */
+    async getTransactionBlocks(digests, options) {
+        const results = [];
+        for (const digest of digests) {
+            try {
+                const result = await this.getTransactionBlock(digest, options);
+                results.push(result);
+            }
+            catch (error) {
+                console.error(`Failed to fetch transaction ${digest}:`, error);
+                // Continue with other transactions
+            }
+        }
+        return results;
+    }
+}
+exports.RpcClient = RpcClient;
+//# sourceMappingURL=rpc-client.js.map

package/dist/src/utils/rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.js","sourceRoot":"","sources":["../../../src/utils/rpc-client.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAKH;;GAEG;AACH,MAAa,SAAS;IAKpB,YAAY,MAAc,EAAE,cAAsB,IAAI;QAF9C,oBAAe,GAAW,CAAC,CAAC;QAGlC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,SAAS;QACf,qCAAqC;QACrC,4DAA4D;QAC5D,uCAAuC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAa,CAAC;QAC/B,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC;IACrE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;QAExD,IAAI,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,GAAG,oBAAoB,CAAC;YACzD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,MAAc,EACd,OAA4C;QAE5C,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,gDAAgD;QAChD,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;YAC/D,OAAO,MAAM,MAAM,CAAC,mBAAmB,CAAC;gBACtC,MAAM;gBACN,OAAO,EAAE,OAAO,IAAI;oBAClB,SAAS,EAAE,IAAI;oBACf,WAAW,EAAE,IAAI;oBACjB,UAAU,EAAE,IAAI;oBAChB,kBAAkB,EAAE,IAAI;oBACxB,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAC/C,MAAM;gBACN,OAAO,EAAE,OAAO,IAAI;oBAClB,SAAS,EAAE,IAAI;oBACf,WAAW,EAAE,IAAI;oBACjB,UAAU,EAAE,IAAI;oBAChB,kBAAkB,EAAE,IAAI;oBACxB,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAAiB,EACjB,OAA4C;QAE5C,MAAM,OAAO,GAAkC,EAAE,CAAC;QAElD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC/D,mCAAmC;YACrC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAnGD,8BAmGC"}

package/dist/tests/analyzer.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for Analyzer
+ */
+export {};
+//# sourceMappingURL=analyzer.test.d.ts.map

package/dist/tests/analyzer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.test.d.ts","sourceRoot":"","sources":["../../tests/analyzer.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tests/analyzer.test.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Unit tests for Analyzer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const analyzer_1 = require("../src/analyzer/analyzer");
+const types_1 = require("../src/analyzer/types");
+(0, vitest_1.describe)('Analyzer', () => {
+    const analyzer = new analyzer_1.Analyzer();
+    const createMockTraceData = (overrides) => ({
+        digest: 'test-digest',
+        sender: '0x123',
+        status: 'success',
+        gas_computation: 1000,
+        gas_storage: 0,
+        gas_storage_rebate: 0,
+        events: [],
+        balance_changes: [],
+        object_changes: [],
+        ptb_commands: [],
+        num_commands: 0,
+        num_events: 0,
+        num_balance_changes: 0,
+        num_object_changes: 0,
+        objects_created: 0,
+        objects_mutated: 0,
+        objects_deleted: 0,
+        has_move_calls: false,
+        net_balance_change: 0,
+        ...overrides,
+    });
+    (0, vitest_1.it)('should detect inflation violation', async () => {
+        const traceData = createMockTraceData({
+            balance_changes: [
+                {
+                    owner: '0x111',
+                    coinType: '0x2::sui::SUI',
+                    amount: 1000000, // Positive = inflation
+                },
+            ],
+        });
+        const result = await analyzer.analyze(traceData);
+        (0, vitest_1.expect)(result.status).toBe('violations_detected');
+        const inflationCheck = result.invariants.find(inv => inv.name === 'inflation');
+        (0, vitest_1.expect)(inflationCheck?.violated).toBe(true);
+        (0, vitest_1.expect)(inflationCheck?.severity).toBe(types_1.InvariantSeverity.CRITICAL);
+    });
+    (0, vitest_1.it)('should pass inflation check for valid transfers', async () => {
+        const traceData = createMockTraceData({
+            balance_changes: [
+                {
+                    owner: '0x111',
+                    coinType: '0x2::sui::SUI',
+                    amount: -1000000, // Transfer out
+                },
+                {
+                    owner: '0x222',
+                    coinType: '0x2::sui::SUI',
+                    amount: 1000000, // Transfer in
+                },
+            ],
+        });
+        const result = await analyzer.analyze(traceData);
+        const inflationCheck = result.invariants.find(inv => inv.name === 'inflation');
+        (0, vitest_1.expect)(inflationCheck?.violated).toBe(false);
+    });
+    (0, vitest_1.it)('should handle multiple coin types', async () => {
+        const traceData = createMockTraceData({
+            balance_changes: [
+                {
+                    owner: '0x111',
+                    coinType: '0x2::sui::SUI',
+                    amount: -500000,
+                },
+                {
+                    owner: '0x222',
+                    coinType: '0x2::sui::SUI',
+                    amount: 500000,
+                },
+                {
+                    owner: '0x333',
+                    coinType: '0xa::custom_coin::CUSTOM',
+                    amount: 1000000, // Inflation in custom coin
+                },
+            ],
+        });
+        const result = await analyzer.analyze(traceData);
+        (0, vitest_1.expect)(result.status).toBe('violations_detected');
+        const inflationCheck = result.invariants.find(inv => inv.name === 'inflation');
+        (0, vitest_1.expect)(inflationCheck?.violated).toBe(true);
+    });
+    (0, vitest_1.it)('should return safe status when no violations', async () => {
+        const traceData = createMockTraceData({
+            balance_changes: [
+                {
+                    owner: '0x111',
+                    coinType: '0x2::sui::SUI',
+                    amount: -1000000,
+                },
+                {
+                    owner: '0x222',
+                    coinType: '0x2::sui::SUI',
+                    amount: 1000000,
+                },
+            ],
+        });
+        const result = await analyzer.analyze(traceData);
+        (0, vitest_1.expect)(result.status).toBe('safe');
+        (0, vitest_1.expect)(result.summary.violations).toBe(0);
+    });
+    (0, vitest_1.it)('should check individual invariants', () => {
+        const traceData = createMockTraceData({
+            balance_changes: [
+                {
+                    owner: '0x111',
+                    coinType: '0x2::sui::SUI',
+                    amount: 1000000,
+                },
+            ],
+        });
+        const inflationResult = analyzer.checkInflationInvariant(traceData);
+        (0, vitest_1.expect)(inflationResult.violated).toBe(true);
+        const accessControlResult = analyzer.checkAccessControlInvariant(traceData);
+        (0, vitest_1.expect)(accessControlResult.violated).toBe(false);
+    });
+});
+//# sourceMappingURL=analyzer.test.js.map

package/dist/tests/analyzer.test.js.map

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

package/dist/tests/integration.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Integration tests for TangramMover SDK
+ * These tests may require network access or mocks
+ */
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/tests/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../tests/integration.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/tests/integration.test.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Integration tests for TangramMover SDK
+ * These tests may require network access or mocks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const tangram_mover_1 = require("../src/tangram-mover");
+(0, vitest_1.describe)('TangramMover Integration', () => {
+    (0, vitest_1.it)('should initialize with options', () => {
+        const mover = new tangram_mover_1.TangramMover({
+            networkType: 'testnet',
+            rateLimitMs: 500,
+        });
+        (0, vitest_1.expect)(mover).toBeInstanceOf(tangram_mover_1.TangramMover);
+        (0, vitest_1.expect)(typeof mover.getCurrentAddress()).toBe('string');
+    });
+    (0, vitest_1.it)('should initialize with mnemonics', () => {
+        const mover = new tangram_mover_1.TangramMover({
+            mnemonics: 'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12',
+            networkType: 'devnet',
+        });
+        (0, vitest_1.expect)(mover).toBeInstanceOf(tangram_mover_1.TangramMover);
+    });
+    (0, vitest_1.it)('should get address for different account indices', () => {
+        const mover = new tangram_mover_1.TangramMover({
+            mnemonics: 'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12',
+        });
+        const addr0 = mover.getAddress({ accountIndex: 0 });
+        const addr1 = mover.getAddress({ accountIndex: 1 });
+        (0, vitest_1.expect)(addr0).toBeTruthy();
+        (0, vitest_1.expect)(addr1).toBeTruthy();
+        (0, vitest_1.expect)(addr0).not.toBe(addr1);
+    });
+    // Note: Actual transaction tracing tests would require:
+    // 1. A valid Sui RPC endpoint
+    // 2. Real transaction digests
+    // 3. Network access
+    // These are skipped by default but can be enabled for E2E testing
+    vitest_1.it.skip('should trace a real transaction', async () => {
+        // const mover = new TangramMover({
+        //   networkType: 'testnet',
+        // });
+        // This would require a real transaction digest
+        // const trace = await mover.traceTransaction('real-digest-here');
+        // expect(trace).toBeDefined();
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/tests/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../../tests/integration.test.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,mCAA8C;AAC9C,wDAAoD;AAEpD,IAAA,iBAAQ,EAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,4BAAY,CAAC;YAC7B,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,cAAc,CAAC,4BAAY,CAAC,CAAC;QAC3C,IAAA,eAAM,EAAC,OAAO,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG,IAAI,4BAAY,CAAC;YAC7B,SAAS,EAAE,4EAA4E;YACvF,WAAW,EAAE,QAAQ;SACtB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,cAAc,CAAC,4BAAY,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAG,IAAI,4BAAY,CAAC;YAC7B,SAAS,EAAE,4EAA4E;SACxF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QAEpD,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,wDAAwD;IACxD,8BAA8B;IAC9B,8BAA8B;IAC9B,oBAAoB;IACpB,kEAAkE;IAClE,WAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QACpD,mCAAmC;QACnC,4BAA4B;QAC5B,MAAM;QAEN,+CAA+C;QAC/C,kEAAkE;QAClE,+BAA+B;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/tracer.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for Tracer
+ */
+export {};
+//# sourceMappingURL=tracer.test.d.ts.map

package/dist/tests/tracer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.test.d.ts","sourceRoot":"","sources":["../../tests/tracer.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tests/tracer.test.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Unit tests for Tracer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const tracer_1 = require("../src/tracer/tracer");
+(0, vitest_1.describe)('Tracer', () => {
+    let mockRpcClient;
+    let tracer;
+    (0, vitest_1.beforeEach)(() => {
+        mockRpcClient = {
+            getTransactionBlock: vitest_1.vi.fn(),
+            getTransactionBlocks: vitest_1.vi.fn(),
+        };
+        tracer = new tracer_1.Tracer(mockRpcClient);
+    });
+    (0, vitest_1.it)('should fetch and parse transaction trace', async () => {
+        const mockResponse = {
+            digest: 'test-digest-123',
+            transaction: {
+                data: {
+                    sender: '0x123',
+                    gasData: {
+                        payment: [],
+                        owner: '0x123',
+                        price: '1',
+                        budget: '10000',
+                    },
+                    messageVersion: 'v1',
+                    transaction: {
+                        kind: 'ProgrammableTransaction',
+                        inputs: [],
+                        transactions: [],
+                    },
+                },
+                txSignatures: [],
+            },
+            effects: {
+                status: { status: 'success' },
+                gasUsed: {
+                    computationCost: '1000',
+                    storageCost: '500',
+                    storageRebate: '200',
+                    nonRefundableStorageFee: '0',
+                },
+                created: [],
+                mutated: [],
+                deleted: [],
+                wrapped: [],
+                unwrappedThenDeleted: [],
+                executedEpoch: '1',
+                gasObject: {
+                    owner: { AddressOwner: '0x123' },
+                    reference: {
+                        objectId: '0x123',
+                        version: '1',
+                        digest: 'abc123',
+                    },
+                },
+                messageVersion: 'v1',
+                transactionDigest: 'test-digest-123',
+            },
+            events: [],
+            balanceChanges: [],
+            objectChanges: [],
+        };
+        mockRpcClient.getTransactionBlock.mockResolvedValue(mockResponse);
+        const result = await tracer.fetchTrace('test-digest-123');
+        (0, vitest_1.expect)(result.digest).toBe('test-digest-123');
+        (0, vitest_1.expect)(result.sender).toBe('0x123');
+        (0, vitest_1.expect)(result.status).toBe('success');
+        (0, vitest_1.expect)(result.gas_computation).toBe(1000);
+        (0, vitest_1.expect)(mockRpcClient.getTransactionBlock).toHaveBeenCalledWith('test-digest-123');
+    });
+    (0, vitest_1.it)('should handle failed transactions', async () => {
+        const mockResponse = {
+            digest: 'test-digest-456',
+            transaction: {
+                data: {
+                    sender: '0x456',
+                    gasData: {
+                        payment: [],
+                        owner: '0x456',
+                        price: '1',
+                        budget: '10000',
+                    },
+                    messageVersion: 'v1',
+                    transaction: {
+                        kind: 'ProgrammableTransaction',
+                        inputs: [],
+                        transactions: [],
+                    },
+                },
+                txSignatures: [],
+            },
+            effects: {
+                status: { status: 'failure' },
+                gasUsed: {
+                    computationCost: '500',
+                    storageCost: '0',
+                    storageRebate: '0',
+                    nonRefundableStorageFee: '0',
+                },
+                created: [],
+                mutated: [],
+                deleted: [],
+                wrapped: [],
+                unwrappedThenDeleted: [],
+                executedEpoch: '1',
+                gasObject: {
+                    owner: { AddressOwner: '0x456' },
+                    reference: {
+                        objectId: '0x456',
+                        version: '1',
+                        digest: 'def456',
+                    },
+                },
+                messageVersion: 'v1',
+                transactionDigest: 'test-digest-456',
+            },
+            events: [],
+            balanceChanges: [],
+            objectChanges: [],
+        };
+        mockRpcClient.getTransactionBlock.mockResolvedValue(mockResponse);
+        const result = await tracer.fetchTrace('test-digest-456');
+        (0, vitest_1.expect)(result.status).toBe('failure');
+    });
+    (0, vitest_1.it)('should parse balance changes correctly', async () => {
+        const mockResponse = {
+            digest: 'test-digest-789',
+            transaction: {
+                data: {
+                    sender: '0x789',
+                    gasData: {
+                        payment: [],
+                        owner: '0x789',
+                        price: '1',
+                        budget: '10000',
+                    },
+                    messageVersion: 'v1',
+                    transaction: {
+                        kind: 'ProgrammableTransaction',
+                        inputs: [],
+                        transactions: [],
+                    },
+                },
+                txSignatures: [],
+            },
+            effects: {
+                status: { status: 'success' },
+                gasUsed: {
+                    computationCost: '1000',
+                    storageCost: '0',
+                    storageRebate: '0',
+                    nonRefundableStorageFee: '0',
+                },
+                created: [],
+                mutated: [],
+                deleted: [],
+                wrapped: [],
+                unwrappedThenDeleted: [],
+                executedEpoch: '1',
+                gasObject: {
+                    owner: { AddressOwner: '0x789' },
+                    reference: {
+                        objectId: '0x789',
+                        version: '1',
+                        digest: 'ghi789',
+                    },
+                },
+                messageVersion: 'v1',
+                transactionDigest: 'test-digest-789',
+            },
+            events: [],
+            balanceChanges: [
+                {
+                    owner: { AddressOwner: '0x111' },
+                    coinType: '0x2::sui::SUI',
+                    amount: '1000000',
+                },
+                {
+                    owner: { AddressOwner: '0x222' },
+                    coinType: '0x2::sui::SUI',
+                    amount: '-1000000',
+                },
+            ],
+            objectChanges: [],
+        };
+        mockRpcClient.getTransactionBlock.mockResolvedValue(mockResponse);
+        const result = await tracer.fetchTrace('test-digest-789');
+        (0, vitest_1.expect)(result.balance_changes).toHaveLength(2);
+        (0, vitest_1.expect)(result.net_balance_change).toBe(0);
+    });
+});
+//# sourceMappingURL=tracer.test.js.map

package/dist/tests/tracer.test.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@tangram-mover/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Tangram Mover - Transaction trace analyzer for Sui Move protocols",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "npx --package typescript tsc",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "sui",
+    "move",
+    "blockchain",
+    "transaction",
+    "tracing",
+    "invariant",
+    "security"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@mysten/sui": "^1.45.2",
+    "@scallop-io/sui-kit": "^1.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {},
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}