@everstake/wallet-sdk-hysp-solana 1.3.1 → 1.4.1

package/dist/index.d.mts

@@ -88,6 +88,7 @@ declare const ERROR_MESSAGES: {
     GET_BALANCE_ERROR: string;
     VAULT_LOAD_ERROR: string;
     VAULT_NOT_FOUND_ERROR: string;
+    TX_TOO_LARGE: string;
 };
 
 /**
@@ -106,6 +107,7 @@ type VaultsMap = {
     [K in SupportedToken]: VaultInfo;
 };
 declare const VAULTS: VaultsMap;
+declare const MAX_TRANSACTION_SIZE = 1232;
 
 /**
  * Copyright (c) 2025, Everstake.
@@ -170,6 +172,7 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
     };
     protected ORIGINAL_ERROR_MESSAGES: {
         INITIALIZATION_ERROR: string;
@@ -179,6 +182,7 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
     };
     private connection;
     private vault;
@@ -282,4 +286,4 @@ declare class HyspSolana extends Blockchain {
     private buildTx;
 }
 
-export { type ApiResponse, Blockchain, ERROR_MESSAGES, HyspSolana, type Params, type ShareToken, type SupportedToken, VAULTS, type VaultContracts, type VaultInfo, type VaultMeta, type VaultsMap, WalletSDKError };
+export { type ApiResponse, Blockchain, ERROR_MESSAGES, HyspSolana, MAX_TRANSACTION_SIZE, type Params, type ShareToken, type SupportedToken, VAULTS, type VaultContracts, type VaultInfo, type VaultMeta, type VaultsMap, WalletSDKError };

package/dist/index.d.ts

@@ -88,6 +88,7 @@ declare const ERROR_MESSAGES: {
     GET_BALANCE_ERROR: string;
     VAULT_LOAD_ERROR: string;
     VAULT_NOT_FOUND_ERROR: string;
+    TX_TOO_LARGE: string;
 };
 
 /**
@@ -106,6 +107,7 @@ type VaultsMap = {
     [K in SupportedToken]: VaultInfo;
 };
 declare const VAULTS: VaultsMap;
+declare const MAX_TRANSACTION_SIZE = 1232;
 
 /**
  * Copyright (c) 2025, Everstake.
@@ -170,6 +172,7 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
     };
     protected ORIGINAL_ERROR_MESSAGES: {
         INITIALIZATION_ERROR: string;
@@ -179,6 +182,7 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
     };
     private connection;
     private vault;
@@ -282,4 +286,4 @@ declare class HyspSolana extends Blockchain {
     private buildTx;
 }
 
-export { type ApiResponse, Blockchain, ERROR_MESSAGES, HyspSolana, type Params, type ShareToken, type SupportedToken, VAULTS, type VaultContracts, type VaultInfo, type VaultMeta, type VaultsMap, WalletSDKError };
+export { type ApiResponse, Blockchain, ERROR_MESSAGES, HyspSolana, MAX_TRANSACTION_SIZE, type Params, type ShareToken, type SupportedToken, VAULTS, type VaultContracts, type VaultInfo, type VaultMeta, type VaultsMap, WalletSDKError };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   Blockchain: () => Blockchain,
   ERROR_MESSAGES: () => ERROR_MESSAGES,
   HyspSolana: () => HyspSolana,
+  MAX_TRANSACTION_SIZE: () => MAX_TRANSACTION_SIZE,
   VAULTS: () => VAULTS,
   WalletSDKError: () => WalletSDKError
 });
@@ -126,7 +127,8 @@ var ERROR_MESSAGES = {
   GET_SHARES_ERROR: "An error occurred while fetching vault balance",
   GET_BALANCE_ERROR: "An error occurred while fetching user token balance",
   VAULT_LOAD_ERROR: "An error occurred while loading vault info",
-  VAULT_NOT_FOUND_ERROR: "Vault not found for token: {0}"
+  VAULT_NOT_FOUND_ERROR: "Vault not found for token: {0}",
+  TX_TOO_LARGE: "Transaction exceeds the maximum size limit of 1232 bytes"
 };
 
 // src/constants/index.ts
@@ -134,12 +136,13 @@ var import_kit = require("@solana/kit");
 var VAULTS = {
   // Gauntlet USDC Prime
   USDC: {
-    address: (0, import_kit.address)("9E69U4GzWhryRaPe8DYpco6Z9vTZY6gg8w6W2QsBACEj"),
+    address: (0, import_kit.address)("HptboyAsrs3xPQUMDT31gHLW3tzrq6p6As56EK7VXMcL"),
     shareTokenAddress: (0, import_kit.address)("32XLsweyeQwWgLKRVAzS72nxHGU1JmmNQQZ3C3q6fBjJ"),
     shareTokenSymbol: "Kamino Reserve Collateral (USDC) Token",
     shareTokenDecimals: 6
   }
 };
+var MAX_TRANSACTION_SIZE = 1232;
 
 // src/hysp.ts
 var HyspSolana = class extends Blockchain {
@@ -427,10 +430,9 @@ var HyspSolana = class extends Blockchain {
     return (0, import_memo.getAddMemoInstruction)({ memo: processedMemo });
   }
   async buildTx(sender, instructions, params, lookupTableAddresses) {
-    let transactionMessage = (0, import_kit2.pipe)(
-      (0, import_kit2.createTransactionMessage)({ version: 0 }),
-      (tx) => (0, import_kit2.setTransactionMessageFeePayer)((0, import_kit2.address)(sender), tx)
-    );
+    let transactionMessage = (0, import_kit2.createTransactionMessage)({
+      version: 0
+    });
     if (params?.computeUnitLimit !== void 0 && params?.computeUnitLimit > 0) {
       const unitLimitInstruction = (0, import_compute_budget.getSetComputeUnitLimitInstruction)({
         /** Transaction compute unit limit used for prioritization fees. */
@@ -482,11 +484,21 @@ var HyspSolana = class extends Blockchain {
         fetchedTables
       );
     }
+    const txWithFeePayer = (0, import_kit2.setTransactionMessageFeePayer)(
+      (0, import_kit2.address)(sender),
+      transactionMessage
+    );
     const finalLatestBlockhash = params?.finalLatestBlockhash || (await this.connection.getLatestBlockhash().send()).value;
     const txMessageWithBlockhashLifetime = (0, import_kit2.setTransactionMessageLifetimeUsingBlockhash)(
       finalLatestBlockhash,
-      transactionMessage
+      txWithFeePayer
     );
+    const compiledTx = (0, import_kit2.compileTransaction)(txMessageWithBlockhashLifetime);
+    const serializedTx = (0, import_kit2.getTransactionEncoder)().encode(compiledTx);
+    const txSize = serializedTx.length;
+    if (txSize > MAX_TRANSACTION_SIZE) {
+      throw this.throwError("TX_TOO_LARGE");
+    }
     return txMessageWithBlockhashLifetime;
   }
 };
@@ -495,6 +507,7 @@ var HyspSolana = class extends Blockchain {
   Blockchain,
   ERROR_MESSAGES,
   HyspSolana,
+  MAX_TRANSACTION_SIZE,
   VAULTS,
   WalletSDKError
 });

package/dist/index.mjs

@@ -3,14 +3,15 @@ import {
   createSolanaRpc,
   createNoopSigner,
   address as address2,
-  pipe,
   createTransactionMessage,
   setTransactionMessageFeePayer,
   setTransactionMessageLifetimeUsingBlockhash,
   appendTransactionMessageInstruction,
   prependTransactionMessageInstruction,
   compressTransactionMessageUsingAddressLookupTables,
-  fetchAddressesForLookupTables
+  fetchAddressesForLookupTables,
+  compileTransaction,
+  getTransactionEncoder
 } from "@solana/kit";
 import {
   getSetComputeUnitLimitInstruction,
@@ -111,7 +112,8 @@ var ERROR_MESSAGES = {
   GET_SHARES_ERROR: "An error occurred while fetching vault balance",
   GET_BALANCE_ERROR: "An error occurred while fetching user token balance",
   VAULT_LOAD_ERROR: "An error occurred while loading vault info",
-  VAULT_NOT_FOUND_ERROR: "Vault not found for token: {0}"
+  VAULT_NOT_FOUND_ERROR: "Vault not found for token: {0}",
+  TX_TOO_LARGE: "Transaction exceeds the maximum size limit of 1232 bytes"
 };
 
 // src/constants/index.ts
@@ -119,12 +121,13 @@ import { address } from "@solana/kit";
 var VAULTS = {
   // Gauntlet USDC Prime
   USDC: {
-    address: address("9E69U4GzWhryRaPe8DYpco6Z9vTZY6gg8w6W2QsBACEj"),
+    address: address("HptboyAsrs3xPQUMDT31gHLW3tzrq6p6As56EK7VXMcL"),
     shareTokenAddress: address("32XLsweyeQwWgLKRVAzS72nxHGU1JmmNQQZ3C3q6fBjJ"),
     shareTokenSymbol: "Kamino Reserve Collateral (USDC) Token",
     shareTokenDecimals: 6
   }
 };
+var MAX_TRANSACTION_SIZE = 1232;
 
 // src/hysp.ts
 var HyspSolana = class extends Blockchain {
@@ -412,10 +415,9 @@ var HyspSolana = class extends Blockchain {
     return getAddMemoInstruction({ memo: processedMemo });
   }
   async buildTx(sender, instructions, params, lookupTableAddresses) {
-    let transactionMessage = pipe(
-      createTransactionMessage({ version: 0 }),
-      (tx) => setTransactionMessageFeePayer(address2(sender), tx)
-    );
+    let transactionMessage = createTransactionMessage({
+      version: 0
+    });
     if (params?.computeUnitLimit !== void 0 && params?.computeUnitLimit > 0) {
       const unitLimitInstruction = getSetComputeUnitLimitInstruction({
         /** Transaction compute unit limit used for prioritization fees. */
@@ -467,11 +469,21 @@ var HyspSolana = class extends Blockchain {
         fetchedTables
       );
     }
+    const txWithFeePayer = setTransactionMessageFeePayer(
+      address2(sender),
+      transactionMessage
+    );
     const finalLatestBlockhash = params?.finalLatestBlockhash || (await this.connection.getLatestBlockhash().send()).value;
     const txMessageWithBlockhashLifetime = setTransactionMessageLifetimeUsingBlockhash(
       finalLatestBlockhash,
-      transactionMessage
+      txWithFeePayer
     );
+    const compiledTx = compileTransaction(txMessageWithBlockhashLifetime);
+    const serializedTx = getTransactionEncoder().encode(compiledTx);
+    const txSize = serializedTx.length;
+    if (txSize > MAX_TRANSACTION_SIZE) {
+      throw this.throwError("TX_TOO_LARGE");
+    }
     return txMessageWithBlockhashLifetime;
   }
 };
@@ -479,6 +491,7 @@ export {
   Blockchain,
   ERROR_MESSAGES,
   HyspSolana,
+  MAX_TRANSACTION_SIZE,
   VAULTS,
   WalletSDKError
 };

package/jest.config.ts

@@ -9,10 +9,11 @@ const config: Config = {
   collectCoverageFrom: [
     'src/**/*.ts',
     '!src/**/*.d.ts',
-    '!src/**/index.ts',
+    '!src/index.ts',
   ],
   coverageDirectory: 'coverage',
   coverageReporters: ['text', 'lcov', 'html'],
+  testTimeout: 60000,
 };
 
 export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everstake/wallet-sdk-hysp-solana",
-  "version": "1.3.1",
+  "version": "1.4.1",
   "description": "HYSP Solana - Everstake Wallet SDK",
   "publishConfig": {
     "access": "public"

package/src/__tests__/transaction-size.ts

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) 2025, Everstake.
+ * Licensed under the BSD-3-Clause License. See LICENSE file for details.
+ */
+
+import { address, Instruction } from '@solana/kit';
+import { Decimal } from 'decimal.js';
+import { HyspSolana } from '../hysp';
+
+declare global {
+  interface BigInt {
+    toJSON(): number;
+  }
+}
+
+BigInt.prototype.toJSON = function () {
+  return Number(this);
+};
+
+const PLACEHOLDER_USER_ADDRESS = address(
+  'Crc3qfV8QqdmGXNWSQnc8REsrDjViiSZMyjn6jsE51kj',
+);
+const PLACEHOLDER_TARGET_ADDRESS = address('11111111111111111111111111111113');
+const PLACEHOLDER_SHARES_AMOUNT = new Decimal('0.1');
+
+function createAdditionalInstruction(): Instruction {
+  return {
+    programAddress: address('11111111111111111111111111111112'),
+    accounts: [
+      { address: PLACEHOLDER_USER_ADDRESS, role: 0 },
+      { address: PLACEHOLDER_TARGET_ADDRESS, role: 0 },
+    ],
+    data: new Uint8Array(
+      Array.from({ length: 12 }, () => Math.floor(Math.random() * 256)),
+    ),
+  } as unknown as Instruction;
+}
+
+describe('HyspSolana Transaction Size Tests', () => {
+  let hyspSolana: HyspSolana;
+
+  beforeAll(() => {
+    hyspSolana = new HyspSolana('USDC');
+  });
+
+  describe('Transaction Size Limits', () => {
+    it('should check balance and error if insufficient shares', async () => {
+      const userShares = await hyspSolana.getUserShares(
+        PLACEHOLDER_USER_ADDRESS,
+      );
+
+      console.log(`User shares: ${userShares.result.toString()}`);
+
+      if (userShares.result.lt(PLACEHOLDER_SHARES_AMOUNT)) {
+        console.warn('Insufficient shares for tests.');
+        fail(
+          'Insufficient shares for tests. Cannot proceed with transaction size tests.',
+        );
+      }
+    }, 30000);
+
+    it('should create a normal withdraw transaction within size limits', async () => {
+      const result = await hyspSolana.withdraw(
+        PLACEHOLDER_USER_ADDRESS,
+        PLACEHOLDER_SHARES_AMOUNT,
+      );
+
+      expect(result.result).toBeDefined();
+    }, 30000);
+
+    it('should fail when transaction exceeds size limits with too many instructions', async () => {
+      const additionalInstructions = [];
+
+      for (let i = 0; i < 100; i++) {
+        additionalInstructions.push(createAdditionalInstruction());
+      }
+
+      await expect(
+        hyspSolana.withdraw(
+          PLACEHOLDER_USER_ADDRESS,
+          PLACEHOLDER_SHARES_AMOUNT,
+          {
+            afterInstructions: additionalInstructions,
+          },
+        ),
+      ).rejects.toThrow(
+        'Transaction exceeds the maximum size limit of 1232 bytes',
+      );
+    }, 30000);
+
+    it('should handle edge case with some additional instructions', async () => {
+      const moderateInstructions = [];
+
+      for (let i = 0; i < 10; i++) {
+        moderateInstructions.push(createAdditionalInstruction());
+      }
+
+      try {
+        const result = await hyspSolana.withdraw(
+          PLACEHOLDER_USER_ADDRESS,
+          PLACEHOLDER_SHARES_AMOUNT,
+          {
+            afterInstructions: moderateInstructions,
+          },
+        );
+
+        expect(result.result).toBeDefined();
+      } catch (error: unknown) {
+        const errorMessage = (error as Error).message;
+        expect(errorMessage).toContain(
+          'Transaction exceeds the maximum size limit',
+        );
+      }
+    }, 30000);
+  });
+});

package/src/constants/errors.ts

@@ -11,4 +11,5 @@ export const ERROR_MESSAGES = {
   GET_BALANCE_ERROR: 'An error occurred while fetching user token balance',
   VAULT_LOAD_ERROR: 'An error occurred while loading vault info',
   VAULT_NOT_FOUND_ERROR: 'Vault not found for token: {0}',
+  TX_TOO_LARGE: 'Transaction exceeds the maximum size limit of 1232 bytes',
 };

package/src/constants/index.ts

@@ -21,11 +21,13 @@ export type VaultsMap = {
 export const VAULTS: VaultsMap = {
   // Gauntlet USDC Prime
   USDC: {
-    address: address('9E69U4GzWhryRaPe8DYpco6Z9vTZY6gg8w6W2QsBACEj'),
+    address: address('HptboyAsrs3xPQUMDT31gHLW3tzrq6p6As56EK7VXMcL'),
     shareTokenAddress: address('32XLsweyeQwWgLKRVAzS72nxHGU1JmmNQQZ3C3q6fBjJ'),
     shareTokenSymbol: 'Kamino Reserve Collateral (USDC) Token',
     shareTokenDecimals: 6,
   },
 };
 
+export const MAX_TRANSACTION_SIZE = 1232;
+
 export * from './errors';

package/src/hysp.ts

@@ -8,7 +8,6 @@ import {
   Address,
   createNoopSigner,
   address,
-  pipe,
   createTransactionMessage,
   setTransactionMessageFeePayer,
   setTransactionMessageLifetimeUsingBlockhash,
@@ -21,6 +20,8 @@ import {
   Rpc,
   SolanaRpcApi,
   Instruction,
+  compileTransaction,
+  getTransactionEncoder,
 } from '@solana/kit';
 
 import {
@@ -35,6 +36,7 @@ import { KaminoVault, VaultHoldings, APY } from '@kamino-finance/klend-sdk';
 import { Decimal } from 'decimal.js';
 import { Blockchain } from '../../utils';
 import { ERROR_MESSAGES } from './constants/errors';
+import { MAX_TRANSACTION_SIZE } from './constants';
 import { VAULTS, SupportedToken, VaultInfo } from './constants';
 import { ApiResponse, Params, VaultMeta } from './types';
 
@@ -387,10 +389,9 @@ export class HyspSolana extends Blockchain {
     params?: Params,
     lookupTableAddresses?: Address[],
   ): Promise<TransactionMessageWithLifetime> {
-    let transactionMessage: TransactionMessage = pipe(
-      createTransactionMessage({ version: 0 }),
-      (tx) => setTransactionMessageFeePayer(address(sender), tx),
-    );
+    let transactionMessage: TransactionMessage = createTransactionMessage({
+      version: 0,
+    });
 
     if (
       params?.computeUnitLimit !== undefined &&
@@ -457,6 +458,11 @@ export class HyspSolana extends Blockchain {
       );
     }
 
+    const txWithFeePayer = setTransactionMessageFeePayer(
+      address(sender),
+      transactionMessage,
+    );
+
     const finalLatestBlockhash =
       params?.finalLatestBlockhash ||
       (await this.connection.getLatestBlockhash().send()).value;
@@ -464,9 +470,17 @@ export class HyspSolana extends Blockchain {
     const txMessageWithBlockhashLifetime =
       setTransactionMessageLifetimeUsingBlockhash(
         finalLatestBlockhash,
-        transactionMessage,
+        txWithFeePayer,
       );
 
+    const compiledTx = compileTransaction(txMessageWithBlockhashLifetime);
+    const serializedTx = getTransactionEncoder().encode(compiledTx);
+    const txSize = serializedTx.length;
+
+    if (txSize > MAX_TRANSACTION_SIZE) {
+      throw this.throwError('TX_TOO_LARGE');
+    }
+
     return txMessageWithBlockhashLifetime;
   }
 }