@solana/kora 0.0.0 → 0.1.1

package/dist/test/unit.test.js

@@ -0,0 +1,553 @@
+import { KoraClient } from '../src/client.js';
+import { TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
+import { getInstructionsFromBase64Message } from '../src/utils/transaction.js';
+// Mock fetch globally
+const mockFetch = jest.fn();
+global.fetch = mockFetch;
+describe('KoraClient Unit Tests', () => {
+    let client;
+    const mockRpcUrl = 'http://localhost:8080';
+    // Helper Functions
+    const mockSuccessfulResponse = (result) => {
+        mockFetch.mockResolvedValueOnce({
+            json: jest.fn().mockResolvedValueOnce({
+                jsonrpc: '2.0',
+                id: 1,
+                result,
+            }),
+        });
+    };
+    const mockErrorResponse = (error) => {
+        mockFetch.mockResolvedValueOnce({
+            json: jest.fn().mockResolvedValueOnce({
+                jsonrpc: '2.0',
+                id: 1,
+                error,
+            }),
+        });
+    };
+    const expectRpcCall = (method, params = undefined) => {
+        expect(mockFetch).toHaveBeenCalledWith(mockRpcUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method,
+                params,
+            }),
+        });
+    };
+    const testSuccessfulRpcMethod = async (methodName, clientMethod, expectedResult, params = undefined) => {
+        mockSuccessfulResponse(expectedResult);
+        const result = await clientMethod();
+        expect(result).toEqual(expectedResult);
+        expectRpcCall(methodName, params);
+    };
+    beforeEach(() => {
+        client = new KoraClient({ rpcUrl: mockRpcUrl });
+        mockFetch.mockClear();
+    });
+    afterEach(() => {
+        jest.resetAllMocks();
+    });
+    describe('Constructor', () => {
+        it('should create KoraClient instance with provided RPC URL', () => {
+            const testUrl = 'https://api.example.com';
+            const testClient = new KoraClient({ rpcUrl: testUrl });
+            expect(testClient).toBeInstanceOf(KoraClient);
+        });
+    });
+    describe('RPC Request Handling', () => {
+        it('should handle successful RPC responses', async () => {
+            const mockResult = { value: 'test' };
+            await testSuccessfulRpcMethod('getConfig', () => client.getConfig(), mockResult);
+        });
+        it('should handle RPC error responses', async () => {
+            const mockError = { code: -32601, message: 'Method not found' };
+            mockErrorResponse(mockError);
+            await expect(client.getConfig()).rejects.toThrow('RPC Error -32601: Method not found');
+        });
+        it('should handle network errors', async () => {
+            mockFetch.mockRejectedValueOnce(new Error('Network error'));
+            await expect(client.getConfig()).rejects.toThrow('Network error');
+        });
+    });
+    describe('getConfig', () => {
+        it('should return configuration', async () => {
+            const mockConfig = {
+                fee_payers: ['test_fee_payer_address'],
+                validation_config: {
+                    max_allowed_lamports: 1000000,
+                    max_signatures: 10,
+                    price_source: 'Jupiter',
+                    allowed_programs: ['program1', 'program2'],
+                    allowed_tokens: ['token1', 'token2'],
+                    allowed_spl_paid_tokens: ['spl_token1'],
+                    disallowed_accounts: ['account1'],
+                    fee_payer_policy: {
+                        system: {
+                            allow_transfer: true,
+                            allow_assign: true,
+                            allow_create_account: true,
+                            allow_allocate: true,
+                            nonce: {
+                                allow_initialize: true,
+                                allow_advance: true,
+                                allow_authorize: true,
+                                allow_withdraw: true,
+                            },
+                        },
+                        spl_token: {
+                            allow_transfer: true,
+                            allow_burn: true,
+                            allow_close_account: true,
+                            allow_approve: true,
+                            allow_revoke: true,
+                            allow_set_authority: true,
+                            allow_mint_to: true,
+                            allow_freeze_account: true,
+                            allow_thaw_account: true,
+                        },
+                        token_2022: {
+                            allow_transfer: false,
+                            allow_burn: true,
+                            allow_close_account: true,
+                            allow_approve: true,
+                            allow_revoke: true,
+                            allow_set_authority: true,
+                            allow_mint_to: true,
+                            allow_freeze_account: true,
+                            allow_thaw_account: true,
+                        },
+                    },
+                    price: {
+                        type: 'margin',
+                        margin: 0.1,
+                    },
+                    token2022: {
+                        blocked_mint_extensions: ['extension1', 'extension2'],
+                        blocked_account_extensions: ['account_extension1', 'account_extension2'],
+                    },
+                },
+                enabled_methods: {
+                    liveness: true,
+                    estimate_transaction_fee: true,
+                    get_supported_tokens: true,
+                    sign_transaction: true,
+                    sign_and_send_transaction: true,
+                    transfer_transaction: true,
+                    get_blockhash: true,
+                    get_config: true,
+                },
+            };
+            await testSuccessfulRpcMethod('getConfig', () => client.getConfig(), mockConfig);
+        });
+    });
+    describe('getBlockhash', () => {
+        it('should return blockhash', async () => {
+            const mockResponse = {
+                blockhash: 'test_blockhash_value',
+            };
+            await testSuccessfulRpcMethod('getBlockhash', () => client.getBlockhash(), mockResponse);
+        });
+    });
+    describe('getSupportedTokens', () => {
+        it('should return supported tokens list', async () => {
+            const mockResponse = {
+                tokens: ['SOL', 'USDC', 'USDT'],
+            };
+            await testSuccessfulRpcMethod('getSupportedTokens', () => client.getSupportedTokens(), mockResponse);
+        });
+    });
+    describe('getPayerSigner', () => {
+        it('should return payer signer and payment destination', async () => {
+            const mockResponse = {
+                signer_address: 'DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+                payment_address: 'PayKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+            };
+            await testSuccessfulRpcMethod('getPayerSigner', () => client.getPayerSigner(), mockResponse);
+        });
+        it('should return same address for signer and payment_destination when no separate paymaster', async () => {
+            const mockResponse = {
+                signer_address: 'DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+                payment_address: 'DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+            };
+            await testSuccessfulRpcMethod('getPayerSigner', () => client.getPayerSigner(), mockResponse);
+            expect(mockResponse.signer_address).toBe(mockResponse.payment_address);
+        });
+    });
+    describe('estimateTransactionFee', () => {
+        it('should estimate transaction fee', async () => {
+            const request = {
+                transaction: 'base64_encoded_transaction',
+                fee_token: 'SOL',
+            };
+            const mockResponse = {
+                fee_in_lamports: 5000,
+                fee_in_token: 25,
+                signer_pubkey: 'DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+                payment_address: 'PayKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+            };
+            await testSuccessfulRpcMethod('estimateTransactionFee', () => client.estimateTransactionFee(request), mockResponse, request);
+        });
+    });
+    describe('signTransaction', () => {
+        it('should sign transaction', async () => {
+            const request = {
+                transaction: 'base64_encoded_transaction',
+            };
+            const mockResponse = {
+                signed_transaction: 'base64_signed_transaction',
+                signer_pubkey: 'test_signer_pubkey',
+            };
+            await testSuccessfulRpcMethod('signTransaction', () => client.signTransaction(request), mockResponse, request);
+        });
+    });
+    describe('signAndSendTransaction', () => {
+        it('should sign and send transaction', async () => {
+            const request = {
+                transaction: 'base64_encoded_transaction',
+            };
+            const mockResponse = {
+                signature: 'transaction_signature',
+                signed_transaction: 'base64_signed_transaction',
+                signer_pubkey: 'test_signer_pubkey',
+            };
+            await testSuccessfulRpcMethod('signAndSendTransaction', () => client.signAndSendTransaction(request), mockResponse, request);
+        });
+    });
+    describe('transferTransaction', () => {
+        it('should create transfer transaction', async () => {
+            const request = {
+                amount: 1000000,
+                token: 'SOL',
+                source: 'source_address',
+                destination: 'destination_address',
+            };
+            const mockResponse = {
+                transaction: 'base64_encoded_transaction',
+                message: 'Transfer transaction created',
+                blockhash: 'test_blockhash',
+                signer_pubkey: 'test_signer_pubkey',
+                instructions: [],
+            };
+            await testSuccessfulRpcMethod('transferTransaction', () => client.transferTransaction(request), mockResponse, request);
+        });
+        it('should parse instructions from transfer transaction message', async () => {
+            const request = {
+                amount: 1000000,
+                token: 'SOL',
+                source: 'source_address',
+                destination: 'destination_address',
+            };
+            // This is a real base64 encoded message for testing
+            // In production, this would come from the RPC response
+            const mockMessage = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQABAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIDAAEMAgAAAAEAAAAAAAAA';
+            const mockResponse = {
+                transaction: 'base64_encoded_transaction',
+                message: mockMessage,
+                blockhash: 'test_blockhash',
+                signer_pubkey: 'test_signer_pubkey',
+                instructions: [],
+            };
+            mockSuccessfulResponse(mockResponse);
+            const result = await client.transferTransaction(request);
+            expect(result.instructions).toBeDefined();
+            expect(Array.isArray(result.instructions)).toBe(true);
+            // The instructions array should be populated from the parsed message
+            expect(result.instructions).not.toBeNull();
+        });
+        it('should handle transfer transaction with empty message gracefully', async () => {
+            const request = {
+                amount: 1000000,
+                token: 'SOL',
+                source: 'source_address',
+                destination: 'destination_address',
+            };
+            const mockResponse = {
+                transaction: 'base64_encoded_transaction',
+                message: '',
+                blockhash: 'test_blockhash',
+                signer_pubkey: 'test_signer_pubkey',
+                instructions: [],
+            };
+            mockSuccessfulResponse(mockResponse);
+            const result = await client.transferTransaction(request);
+            // Should handle empty message gracefully
+            expect(result.instructions).toEqual([]);
+        });
+    });
+    describe('getPaymentInstruction', () => {
+        const mockConfig = {
+            fee_payers: ['11111111111111111111111111111111'],
+            validation_config: {
+                max_allowed_lamports: 1000000,
+                max_signatures: 10,
+                price_source: 'Jupiter',
+                allowed_programs: ['program1'],
+                allowed_tokens: ['token1'],
+                allowed_spl_paid_tokens: ['4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU'],
+                disallowed_accounts: [],
+                fee_payer_policy: {
+                    system: {
+                        allow_transfer: true,
+                        allow_assign: true,
+                        allow_create_account: true,
+                        allow_allocate: true,
+                        nonce: {
+                            allow_initialize: true,
+                            allow_advance: true,
+                            allow_authorize: true,
+                            allow_withdraw: true,
+                        },
+                    },
+                    spl_token: {
+                        allow_transfer: true,
+                        allow_burn: true,
+                        allow_close_account: true,
+                        allow_approve: true,
+                        allow_revoke: true,
+                        allow_set_authority: true,
+                        allow_mint_to: true,
+                        allow_freeze_account: true,
+                        allow_thaw_account: true,
+                    },
+                    token_2022: {
+                        allow_transfer: true,
+                        allow_burn: true,
+                        allow_close_account: true,
+                        allow_approve: true,
+                        allow_revoke: true,
+                        allow_set_authority: true,
+                        allow_mint_to: true,
+                        allow_freeze_account: true,
+                        allow_thaw_account: true,
+                    },
+                },
+                price: {
+                    type: 'margin',
+                    margin: 0.1,
+                },
+                token2022: {
+                    blocked_mint_extensions: [],
+                    blocked_account_extensions: [],
+                },
+            },
+            enabled_methods: {
+                liveness: true,
+                estimate_transaction_fee: true,
+                get_supported_tokens: true,
+                sign_transaction: true,
+                sign_and_send_transaction: true,
+                transfer_transaction: true,
+                get_blockhash: true,
+                get_config: true,
+            },
+        };
+        const mockFeeEstimate = {
+            fee_in_lamports: 5000,
+            fee_in_token: 50000,
+            signer_pubkey: 'DemoKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+            payment_address: 'PayKMZWkk483QoFPLRPQ2XVKB7bWnuXwSjvDE1JsWk7',
+        };
+        // Create a mock base64-encoded transaction
+        // This is a minimal valid transaction structure
+        const mockTransactionBase64 = 'Aoq7ymA5OGP+gmDXiY5m3cYXlY2Rz/a/gFjOgt9ZuoCS7UzuiGGaEnW2OOtvHvMQHkkD7Z4LRF5B63ftu+1oZwIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgECB1urjQEjgFgzqYhJ8IXJeSg4cJP1j1g2CJstOQTDchOKUzqH3PxgGW3c4V3vZV05A5Y30/MggOBs0Kd00s1JEwg5TaEeaV4+KL2y7fXIAuf6cN0ZQitbhY+G9ExtBSChspOXPgNcy9pYpETe4bmB+fg4bfZx1tnicA/kIyyubczAmbcIKIuniNOOQYG2ggKCz8NjEsHVezrWMatndu1wk6J5miGP26J6Vwp31AljiAajAFuP0D9mWJwSeFuA7J5rPwbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpd/O36SW02zRtNtqk6GFeip2+yBQsVTeSbLL4rWJRkd4CBgQCBQQBCgxAQg8AAAAAAAYGBAIFAwEKDBAnAAAAAAAABg==';
+        const validRequest = {
+            transaction: mockTransactionBase64,
+            fee_token: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+            source_wallet: '11111111111111111111111111111111',
+            token_program_id: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
+        };
+        beforeEach(() => {
+            // Mock console.log to avoid noise in tests
+            jest.spyOn(console, 'log').mockImplementation();
+        });
+        afterEach(() => {
+            jest.restoreAllMocks();
+        });
+        it('should successfully append payment instruction', async () => {
+            // Mock estimateTransactionFee call
+            mockFetch.mockResolvedValueOnce({
+                json: jest.fn().mockResolvedValueOnce({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    result: mockFeeEstimate,
+                }),
+            });
+            const result = await client.getPaymentInstruction(validRequest);
+            expect(result).toEqual({
+                original_transaction: validRequest.transaction,
+                payment_instruction: expect.objectContaining({
+                    programAddress: TOKEN_PROGRAM_ADDRESS,
+                    accounts: [
+                        expect.objectContaining({
+                            role: 1, // writable
+                        }), // Source token account
+                        expect.objectContaining({
+                            role: 1, // writable
+                        }), // Destination token account
+                        expect.objectContaining({
+                            role: 2, // readonly-signer
+                            address: validRequest.source_wallet,
+                            signer: expect.objectContaining({
+                                address: validRequest.source_wallet,
+                            }),
+                        }), // Authority
+                    ],
+                    data: expect.any(Uint8Array),
+                }),
+                payment_amount: mockFeeEstimate.fee_in_token,
+                payment_token: validRequest.fee_token,
+                payment_address: mockFeeEstimate.payment_address,
+                signer_address: mockFeeEstimate.signer_pubkey,
+            });
+            // Verify only estimateTransactionFee was called
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            expect(mockFetch).toHaveBeenCalledWith(mockRpcUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'estimateTransactionFee',
+                    params: {
+                        transaction: validRequest.transaction,
+                        fee_token: validRequest.fee_token,
+                    },
+                }),
+            });
+        });
+        it('should handle fixed pricing configuration', async () => {
+            // Mock estimateTransactionFee call
+            mockFetch.mockResolvedValueOnce({
+                json: jest.fn().mockResolvedValueOnce({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    result: mockFeeEstimate,
+                }),
+            });
+            const result = await client.getPaymentInstruction(validRequest);
+            expect(result.payment_amount).toBe(mockFeeEstimate.fee_in_token);
+            expect(result.payment_token).toBe(validRequest.fee_token);
+        });
+        it('should throw error for invalid addresses', async () => {
+            const invalidRequests = [
+                { ...validRequest, source_wallet: 'invalid_address' },
+                { ...validRequest, fee_token: 'invalid_token' },
+                { ...validRequest, token_program_id: 'invalid_program' },
+            ];
+            for (const invalidRequest of invalidRequests) {
+                await expect(client.getPaymentInstruction(invalidRequest)).rejects.toThrow();
+            }
+        });
+        it('should handle estimateTransactionFee RPC error', async () => {
+            // Mock failed estimateTransactionFee
+            const mockError = { code: -32602, message: 'Invalid transaction' };
+            mockFetch.mockResolvedValueOnce({
+                json: jest.fn().mockResolvedValueOnce({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    error: mockError,
+                }),
+            });
+            await expect(client.getPaymentInstruction(validRequest)).rejects.toThrow('RPC Error -32602: Invalid transaction');
+        });
+        it('should handle network errors', async () => {
+            mockFetch.mockRejectedValueOnce(new Error('Network error'));
+            await expect(client.getPaymentInstruction(validRequest)).rejects.toThrow('Network error');
+        });
+        it('should return correct payment details in response', async () => {
+            mockFetch.mockResolvedValueOnce({
+                json: jest.fn().mockResolvedValueOnce({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    result: mockFeeEstimate,
+                }),
+            });
+            const result = await client.getPaymentInstruction(validRequest);
+            expect(result).toMatchObject({
+                original_transaction: validRequest.transaction,
+                payment_instruction: expect.any(Object),
+                payment_amount: mockFeeEstimate.fee_in_token,
+                payment_token: validRequest.fee_token,
+                payment_address: mockFeeEstimate.payment_address,
+                signer_address: mockFeeEstimate.signer_pubkey,
+            });
+        });
+    });
+    describe('Error Handling Edge Cases', () => {
+        it('should handle malformed JSON responses', async () => {
+            mockFetch.mockResolvedValueOnce({
+                json: jest.fn().mockRejectedValueOnce(new Error('Invalid JSON')),
+            });
+            await expect(client.getConfig()).rejects.toThrow('Invalid JSON');
+        });
+        it('should handle responses with an error object', async () => {
+            const mockError = { code: -32602, message: 'Invalid params' };
+            mockErrorResponse(mockError);
+            await expect(client.getConfig()).rejects.toThrow('RPC Error -32602: Invalid params');
+        });
+        it('should handle empty error object', async () => {
+            mockErrorResponse({});
+            await expect(client.getConfig()).rejects.toThrow('RPC Error undefined: undefined');
+        });
+    });
+    // TODO: Add Authentication Tests (separate PR)
+    //
+    // describe('Authentication', () => {
+    //     describe('API Key Authentication', () => {
+    //         - Test that x-api-key header is included when apiKey is provided
+    //         - Test requests work without apiKey when not provided
+    //         - Test all RPC methods include the header
+    //     });
+    //
+    //     describe('HMAC Authentication', () => {
+    //         - Test x-timestamp and x-hmac-signature headers are included when hmacSecret is provided
+    //         - Test HMAC signature calculation is correct (SHA256 of timestamp + body)
+    //         - Test timestamp is current (within reasonable bounds)
+    //         - Test requests work without HMAC when not provided
+    //         - Test all RPC methods include the headers
+    //     });
+    //
+    //     describe('Combined Authentication', () => {
+    //         - Test both API key and HMAC headers are included when both are provided
+    //         - Test headers are correctly combined
+    //     });
+    // });
+});
+describe('Transaction Utils', () => {
+    describe('getInstructionsFromBase64Message', () => {
+        it('should parse instructions from a valid base64 message', () => {
+            // This is a sample base64 encoded transaction message
+            const validMessage = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQABAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIDAAEMAgAAAAEAAAAAAAAA';
+            const instructions = getInstructionsFromBase64Message(validMessage);
+            expect(Array.isArray(instructions)).toBe(true);
+            expect(instructions).not.toBeNull();
+        });
+        it('should return empty array for invalid base64 message', () => {
+            const invalidMessage = 'invalid_base64_message';
+            const instructions = getInstructionsFromBase64Message(invalidMessage);
+            expect(Array.isArray(instructions)).toBe(true);
+            expect(instructions).toEqual([]);
+        });
+        it('should return empty array for empty message', () => {
+            const emptyMessage = '';
+            const instructions = getInstructionsFromBase64Message(emptyMessage);
+            expect(Array.isArray(instructions)).toBe(true);
+            expect(instructions).toEqual([]);
+        });
+        it('should handle malformed transaction messages gracefully', () => {
+            // Valid base64 but not a valid transaction message
+            const malformedMessage = 'SGVsbG8gV29ybGQh'; // "Hello World!" in base64
+            const instructions = getInstructionsFromBase64Message(malformedMessage);
+            expect(Array.isArray(instructions)).toBe(true);
+            expect(instructions).toEqual([]);
+        });
+    });
+});

package/package.json

@@ -1,12 +1,69 @@
 {
   "name": "@solana/kora",
-  "version": "0.0.0",
-  "description": "",
-  "license": "ISC",
+  "version": "0.1.1",
+  "description": "TypeScript SDK for Kora RPC",
+  "main": "dist/src/index.js",
+  "type": "module",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kora",
+    "solana",
+    "blockchain",
+    "sdk"
+  ],
   "author": "",
-  "type": "commonjs",
-  "main": "index.js",
+  "license": "MIT",
+  "peerDependencies": {
+    "@solana-program/token": "^0.9.0",
+    "@solana/kit": "^5.0.0"
+  },
+  "devDependencies": {
+    "@solana-program/compute-budget": "^0.11.0",
+    "@solana-program/system": "^0.10.0",
+    "@solana-program/token": "^0.9.0",
+    "@solana/kit": "^5.1.0",
+    "@solana/prettier-config-solana": "^0.0.6",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.17.27",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "dotenv": "^16.4.5",
+    "eslint": "^9.31.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.28.9",
+    "typedoc-plugin-markdown": "^4.8.0",
+    "typescript": "^5.3.3",
+    "ws": "^8.18.3"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc",
+    "test": "jest",
+    "test:auth": "ENABLE_AUTH=true pnpm test integration.test.ts",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:integration": "pnpm test integration.test.ts",
+    "test:integration:auth": "ENABLE_AUTH=true pnpm test integration.test.ts",
+    "test:integration:privy": "KORA_SIGNER_TYPE=privy pnpm test integration.test.ts",
+    "test:integration:turnkey": "KORA_SIGNER_TYPE=turnkey pnpm test integration.test.ts",
+    "test:unit": "pnpm test unit.test.ts",
+    "test:ci:integration": "node scripts/test-with-validator.js",
+    "test:ci:integration:auth": "ENABLE_AUTH=true node scripts/test-with-validator.js",
+    "test:ci:unit": "jest test/unit.test.ts",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "docs": "typedoc --readme none && node scripts/add-toc.js",
+    "docs:html": "typedoc --options typedoc.html.json",
+    "docs:watch": "typedoc --watch",
+    "docs:serve": "pnpm run docs:html && npx serve docs-html",
+    "docs:api": "node scripts/generate-api-docs.js",
+    "docs:all": "pnpm run docs && pnpm run docs:api"
   }
-}
+}