@everstake/wallet-sdk-hysp-solana 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -88,6 +88,10 @@ declare const ERROR_MESSAGES: {
     GET_BALANCE_ERROR: string;
     VAULT_LOAD_ERROR: string;
     VAULT_NOT_FOUND_ERROR: string;
+    TX_TOO_LARGE: string;
+    MEMO_REQUIRED_ERROR: string;
+    MEMO_TOO_LONG_ERROR: string;
+    MEMO_INVALID_CHARACTERS_ERROR: string;
 };
 
 /**
@@ -106,6 +110,7 @@ type VaultsMap = {
     [K in SupportedToken]: VaultInfo;
 };
 declare const VAULTS: VaultsMap;
+declare const MAX_TRANSACTION_SIZE = 1232;
 
 /**
  * Copyright (c) 2025, Everstake.
@@ -170,6 +175,10 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
+        MEMO_REQUIRED_ERROR: string;
+        MEMO_TOO_LONG_ERROR: string;
+        MEMO_INVALID_CHARACTERS_ERROR: string;
     };
     protected ORIGINAL_ERROR_MESSAGES: {
         INITIALIZATION_ERROR: string;
@@ -179,6 +188,10 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
+        MEMO_REQUIRED_ERROR: string;
+        MEMO_TOO_LONG_ERROR: string;
+        MEMO_INVALID_CHARACTERS_ERROR: string;
     };
     private connection;
     private vault;
@@ -282,4 +295,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,10 @@ declare const ERROR_MESSAGES: {
     GET_BALANCE_ERROR: string;
     VAULT_LOAD_ERROR: string;
     VAULT_NOT_FOUND_ERROR: string;
+    TX_TOO_LARGE: string;
+    MEMO_REQUIRED_ERROR: string;
+    MEMO_TOO_LONG_ERROR: string;
+    MEMO_INVALID_CHARACTERS_ERROR: string;
 };
 
 /**
@@ -106,6 +110,7 @@ type VaultsMap = {
     [K in SupportedToken]: VaultInfo;
 };
 declare const VAULTS: VaultsMap;
+declare const MAX_TRANSACTION_SIZE = 1232;
 
 /**
  * Copyright (c) 2025, Everstake.
@@ -170,6 +175,10 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
+        MEMO_REQUIRED_ERROR: string;
+        MEMO_TOO_LONG_ERROR: string;
+        MEMO_INVALID_CHARACTERS_ERROR: string;
     };
     protected ORIGINAL_ERROR_MESSAGES: {
         INITIALIZATION_ERROR: string;
@@ -179,6 +188,10 @@ declare class HyspSolana extends Blockchain {
         GET_BALANCE_ERROR: string;
         VAULT_LOAD_ERROR: string;
         VAULT_NOT_FOUND_ERROR: string;
+        TX_TOO_LARGE: string;
+        MEMO_REQUIRED_ERROR: string;
+        MEMO_TOO_LONG_ERROR: string;
+        MEMO_INVALID_CHARACTERS_ERROR: string;
     };
     private connection;
     private vault;
@@ -282,4 +295,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,11 @@ 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",
+  MEMO_REQUIRED_ERROR: "Memo is required. Please contact us to get your referrer ID.",
+  MEMO_TOO_LONG_ERROR: 'Invalid memo: "{0}". Must be max 64 characters',
+  MEMO_INVALID_CHARACTERS_ERROR: 'Invalid memo: "{0}". Must contain only [A-Za-z0-9:_-] characters'
 };
 
 // src/constants/index.ts
@@ -140,6 +145,7 @@ var VAULTS = {
     shareTokenDecimals: 6
   }
 };
+var MAX_TRANSACTION_SIZE = 1232;
 
 // src/hysp.ts
 var HyspSolana = class extends Blockchain {
@@ -400,37 +406,29 @@ var HyspSolana = class extends Blockchain {
    * @returns Memo instruction
    */
   processMemo(memo) {
-    let processedMemo;
     if (!memo || memo.trim() === "") {
-      processedMemo = "SDK";
+      throw this.throwError("MEMO_REQUIRED_ERROR");
+    }
+    const trimmedMemo = memo.trim();
+    let processedMemo;
+    if (!trimmedMemo.startsWith("SDK")) {
+      processedMemo = `SDK:${trimmedMemo}`;
     } else {
-      const trimmedMemo = memo.trim();
-      if (trimmedMemo === "SDK") {
-        processedMemo = trimmedMemo;
-      } else if (!trimmedMemo.startsWith("SDK:")) {
-        processedMemo = `SDK:${trimmedMemo}`;
-      } else {
-        processedMemo = trimmedMemo;
-      }
+      processedMemo = trimmedMemo;
     }
     if (processedMemo.length > 64) {
-      throw new Error(
-        `Invalid memo: "${processedMemo}". Must be max 64 characters`
-      );
+      throw this.throwError("MEMO_TOO_LONG_ERROR", processedMemo);
     }
     const validPattern = /^[A-Za-z0-9:_-]*$/;
     if (!validPattern.test(processedMemo)) {
-      throw new Error(
-        `Invalid memo: "${processedMemo}". Must contain only [A-Za-z0-9:_-] characters`
-      );
+      throw this.throwError("MEMO_INVALID_CHARACTERS_ERROR", processedMemo);
     }
     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 +480,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 +503,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,11 @@ 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",
+  MEMO_REQUIRED_ERROR: "Memo is required. Please contact us to get your referrer ID.",
+  MEMO_TOO_LONG_ERROR: 'Invalid memo: "{0}". Must be max 64 characters',
+  MEMO_INVALID_CHARACTERS_ERROR: 'Invalid memo: "{0}". Must contain only [A-Za-z0-9:_-] characters'
 };
 
 // src/constants/index.ts
@@ -125,6 +130,7 @@ var VAULTS = {
     shareTokenDecimals: 6
   }
 };
+var MAX_TRANSACTION_SIZE = 1232;
 
 // src/hysp.ts
 var HyspSolana = class extends Blockchain {
@@ -385,37 +391,29 @@ var HyspSolana = class extends Blockchain {
    * @returns Memo instruction
    */
   processMemo(memo) {
-    let processedMemo;
     if (!memo || memo.trim() === "") {
-      processedMemo = "SDK";
+      throw this.throwError("MEMO_REQUIRED_ERROR");
+    }
+    const trimmedMemo = memo.trim();
+    let processedMemo;
+    if (!trimmedMemo.startsWith("SDK")) {
+      processedMemo = `SDK:${trimmedMemo}`;
     } else {
-      const trimmedMemo = memo.trim();
-      if (trimmedMemo === "SDK") {
-        processedMemo = trimmedMemo;
-      } else if (!trimmedMemo.startsWith("SDK:")) {
-        processedMemo = `SDK:${trimmedMemo}`;
-      } else {
-        processedMemo = trimmedMemo;
-      }
+      processedMemo = trimmedMemo;
     }
     if (processedMemo.length > 64) {
-      throw new Error(
-        `Invalid memo: "${processedMemo}". Must be max 64 characters`
-      );
+      throw this.throwError("MEMO_TOO_LONG_ERROR", processedMemo);
     }
     const validPattern = /^[A-Za-z0-9:_-]*$/;
     if (!validPattern.test(processedMemo)) {
-      throw new Error(
-        `Invalid memo: "${processedMemo}". Must contain only [A-Za-z0-9:_-] characters`
-      );
+      throw this.throwError("MEMO_INVALID_CHARACTERS_ERROR", processedMemo);
     }
     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 +465,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 +487,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.4.0",
+  "version": "1.5.0",
   "description": "HYSP Solana - Everstake Wallet SDK",
   "publishConfig": {
     "access": "public"
@@ -16,7 +16,7 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "pnpm run prebuild && tsup src/index.ts --format cjs,esm --dts",
     "type-check": "tsc",
     "lint": "eslint 'src/**/*.{ts,tsx}'",
     "prettier": "prettier --write 'src/**/*.{ts,tsx}'",
@@ -73,7 +73,17 @@
       "js-yaml@>=4.0.0 <4.1.1": ">=4.1.1",
       "glob@>=10.2.0 <10.5.0": ">=10.5.0",
       "js-yaml": ">=4.1.1",
-      "glob": ">=10.5.0"
+      "glob": ">=10.5.0",
+      "lodash@>=4.0.0 <=4.17.22": ">=4.17.23",
+      "diff@>=4.0.0 <4.0.4": ">=4.0.4",
+      "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1",
+      "axios@>=1.0.0 <=1.13.4": ">=1.13.5",
+      "bn.js@>=5.0.0 <5.2.3": ">=5.2.3",
+      "rollup@>=4.0.0 <4.59.0": ">=4.59.0",
+      "minimatch@<10.2.3": ">=10.2.3",
+      "flatted@<3.4.0": ">=3.4.0",
+      "flatted@<=3.4.1": ">=3.4.2",
+      "picomatch@<4.0.4": ">=4.0.4"
     }
   }
 }

package/src/__tests__/processMemo.test.ts

@@ -0,0 +1,146 @@
+/**
+ * Copyright (c) 2025, Everstake.
+ * Licensed under the BSD-3-Clause License. See LICENSE file for details.
+ */
+
+import { HyspSolana } from '..';
+import { SupportedToken } from '../constants';
+import { WalletSDKError } from '../../../utils';
+
+// Create a test class to access protected methods
+class TestableHyspSolana extends HyspSolana {
+  public testProcessMemo(memo?: string) {
+    return this.processMemo(memo);
+  }
+}
+
+describe('HyspSolana processMemo method', () => {
+  const hyspSolana: TestableHyspSolana = new TestableHyspSolana(
+    'USDC' as SupportedToken,
+    'https://api.mainnet-beta.solana.com',
+  );
+
+  describe('Error cases', () => {
+    it('should throw MEMO_REQUIRED_ERROR when memo is undefined', () => {
+      expect(() => hyspSolana.testProcessMemo(undefined)).toThrow(
+        WalletSDKError,
+      );
+      expect(() => hyspSolana.testProcessMemo(undefined)).toThrow(
+        'Memo is required. Please contact us to get your referrer ID.',
+      );
+    });
+
+    it('should throw MEMO_REQUIRED_ERROR when memo is empty string', () => {
+      expect(() => hyspSolana.testProcessMemo('')).toThrow(WalletSDKError);
+      expect(() => hyspSolana.testProcessMemo('')).toThrow(
+        'Memo is required. Please contact us to get your referrer ID.',
+      );
+    });
+
+    it('should throw MEMO_REQUIRED_ERROR when memo is only whitespace', () => {
+      expect(() => hyspSolana.testProcessMemo('   ')).toThrow(WalletSDKError);
+      expect(() => hyspSolana.testProcessMemo('   ')).toThrow(
+        'Memo is required. Please contact us to get your referrer ID.',
+      );
+    });
+
+    it('should throw MEMO_TOO_LONG_ERROR when processed memo exceeds 64 characters', () => {
+      const longMemo = 'a'.repeat(70);
+      expect(() => hyspSolana.testProcessMemo(longMemo)).toThrow(
+        WalletSDKError,
+      );
+      expect(() => hyspSolana.testProcessMemo(longMemo)).toThrow(
+        'Must be max 64 characters',
+      );
+    });
+
+    it('should throw MEMO_INVALID_CHARACTERS_ERROR when memo contains invalid characters', () => {
+      expect(() => hyspSolana.testProcessMemo('test@domain')).toThrow(
+        WalletSDKError,
+      );
+      expect(() => hyspSolana.testProcessMemo('test@domain')).toThrow(
+        'Must contain only [A-Za-z0-9:_-] characters',
+      );
+    });
+
+    it('should throw MEMO_INVALID_CHARACTERS_ERROR when memo contains spaces', () => {
+      expect(() => hyspSolana.testProcessMemo('test memo')).toThrow(
+        WalletSDKError,
+      );
+      expect(() => hyspSolana.testProcessMemo('test memo')).toThrow(
+        'Must contain only [A-Za-z0-9:_-] characters',
+      );
+    });
+
+    it('should throw MEMO_INVALID_CHARACTERS_ERROR when memo contains special characters', () => {
+      expect(() => hyspSolana.testProcessMemo('test!memo#')).toThrow(
+        WalletSDKError,
+      );
+      expect(() => hyspSolana.testProcessMemo('test!memo#')).toThrow(
+        'Must contain only [A-Za-z0-9:_-] characters',
+      );
+    });
+  });
+
+  describe('Success cases', () => {
+    it('should prepend SDK: to memo without SDK prefix', () => {
+      const result = hyspSolana.testProcessMemo('acme:pilotQ1:prod:v1');
+
+      expect(new TextDecoder().decode(result.data)).toBe(
+        'SDK:acme:pilotQ1:prod:v1',
+      );
+    });
+
+    it('should keep memo unchanged when it starts with SDK (but not SDK:)', () => {
+      const result = hyspSolana.testProcessMemo('SDKtest');
+
+      expect(new TextDecoder().decode(result.data)).toBe('SDKtest');
+    });
+
+    it('should keep memo unchanged when it starts with SDK:', () => {
+      const result = hyspSolana.testProcessMemo('SDK:bankxyz::prod:v1');
+
+      expect(new TextDecoder().decode(result.data)).toBe(
+        'SDK:bankxyz::prod:v1',
+      );
+    });
+
+    it('should handle simple referrer ID', () => {
+      const result = hyspSolana.testProcessMemo('referrer123');
+
+      expect(new TextDecoder().decode(result.data)).toBe('SDK:referrer123');
+    });
+
+    it('should handle referrer ID with underscores and hyphens', () => {
+      const result = hyspSolana.testProcessMemo('test_ref-id_123');
+
+      expect(new TextDecoder().decode(result.data)).toBe('SDK:test_ref-id_123');
+    });
+
+    it('should handle referrer ID with colons', () => {
+      const result = hyspSolana.testProcessMemo('org:team:user');
+
+      expect(new TextDecoder().decode(result.data)).toBe('SDK:org:team:user');
+    });
+
+    it('should handle maximum allowed length without SDK prefix', () => {
+      const maxMemo = 'a'.repeat(59); // 59 + 'SDK:' = 63 chars (under limit)
+      const result = hyspSolana.testProcessMemo(maxMemo);
+
+      expect(new TextDecoder().decode(result.data)).toBe(`SDK:${maxMemo}`);
+    });
+
+    it('should handle maximum allowed length with SDK prefix', () => {
+      const maxMemo = 'SDK:' + 'a'.repeat(60); // exactly 64 chars
+      const result = hyspSolana.testProcessMemo(maxMemo);
+
+      expect(new TextDecoder().decode(result.data)).toBe(maxMemo);
+    });
+
+    it('should trim whitespace from memo', () => {
+      const result = hyspSolana.testProcessMemo('  referrer123  ');
+
+      expect(new TextDecoder().decode(result.data)).toBe('SDK:referrer123');
+    });
+  });
+});

package/src/__tests__/transaction-size.test.ts

@@ -0,0 +1,118 @@
+/**
+ * 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 fetch user shares successfully', async () => {
+      const userShares = await hyspSolana.getUserShares(
+        PLACEHOLDER_USER_ADDRESS,
+      );
+
+      console.log(`User shares: ${userShares.result.toString()}`);
+
+      expect(userShares.result).toBeDefined();
+      expect(userShares.result).toBeInstanceOf(Decimal);
+
+      if (userShares.result.lt(PLACEHOLDER_SHARES_AMOUNT)) {
+        console.warn(
+          'Note: User has insufficient shares for withdrawal 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,10 @@ 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',
+  MEMO_REQUIRED_ERROR:
+    'Memo is required. Please contact us to get your referrer ID.',
+  MEMO_TOO_LONG_ERROR: 'Invalid memo: "{0}". Must be max 64 characters',
+  MEMO_INVALID_CHARACTERS_ERROR:
+    'Invalid memo: "{0}". Must contain only [A-Za-z0-9:_-] characters',
 };

package/src/constants/index.ts

@@ -28,4 +28,6 @@ export const VAULTS: VaultsMap = {
   },
 };
 
+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';
 
@@ -349,33 +351,29 @@ export class HyspSolana extends Blockchain {
    * @returns Memo instruction
    */
   protected processMemo(memo?: string): Instruction {
-    // Process memo text
-    let processedMemo: string;
+    // Check if memo is empty
     if (!memo || memo.trim() === '') {
-      processedMemo = 'SDK';
+      throw this.throwError('MEMO_REQUIRED_ERROR');
+    }
+
+    const trimmedMemo = memo.trim();
+    let processedMemo: string;
+
+    // If memo doesn't start with 'SDK', prepend 'SDK:'
+    if (!trimmedMemo.startsWith('SDK')) {
+      processedMemo = `SDK:${trimmedMemo}`;
     } else {
-      const trimmedMemo = memo.trim();
-      if (trimmedMemo === 'SDK') {
-        processedMemo = trimmedMemo;
-      } else if (!trimmedMemo.startsWith('SDK:')) {
-        processedMemo = `SDK:${trimmedMemo}`;
-      } else {
-        processedMemo = trimmedMemo;
-      }
+      processedMemo = trimmedMemo;
     }
 
     // Validate memo
     if (processedMemo.length > 64) {
-      throw new Error(
-        `Invalid memo: "${processedMemo}". Must be max 64 characters`,
-      );
+      throw this.throwError('MEMO_TOO_LONG_ERROR', processedMemo);
     }
 
     const validPattern = /^[A-Za-z0-9:_-]*$/;
     if (!validPattern.test(processedMemo)) {
-      throw new Error(
-        `Invalid memo: "${processedMemo}". Must contain only [A-Za-z0-9:_-] characters`,
-      );
+      throw this.throwError('MEMO_INVALID_CHARACTERS_ERROR', processedMemo);
     }
 
     return getAddMemoInstruction({ memo: processedMemo });
@@ -387,10 +385,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 +454,11 @@ export class HyspSolana extends Blockchain {
       );
     }
 
+    const txWithFeePayer = setTransactionMessageFeePayer(
+      address(sender),
+      transactionMessage,
+    );
+
     const finalLatestBlockhash =
       params?.finalLatestBlockhash ||
       (await this.connection.getLatestBlockhash().send()).value;
@@ -464,9 +466,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;
   }
 }

package/src/__tests__/index.ts

@@ -1,41 +0,0 @@
-/**
- * Copyright (c) 2025, Everstake.
- * Licensed under the BSD-3-Clause License. See LICENSE file for details.
- */
-
-import { HyspSolana } from '..';
-import { SupportedToken } from '../constants';
-
-// Create a test class to access protected methods
-class TestableHyspSolana extends HyspSolana {
-  public testProcessMemo(memo?: string) {
-    return this.processMemo(memo);
-  }
-}
-
-describe('HyspSolana processMemo method', () => {
-  const hyspSolana: TestableHyspSolana = new TestableHyspSolana(
-    'USDC' as SupportedToken,
-    'https://api.mainnet-beta.solana.com',
-  );
-
-  it('should return SDK when memo is empty', () => {
-    const result = hyspSolana.testProcessMemo('');
-
-    expect(new TextDecoder().decode(result.data)).toBe('SDK');
-  });
-
-  it('should prepend SDK: to memo without SDK prefix', () => {
-    const result = hyspSolana.testProcessMemo('acme:pilotQ1:prod:v1');
-
-    expect(new TextDecoder().decode(result.data)).toBe(
-      'SDK:acme:pilotQ1:prod:v1',
-    );
-  });
-
-  it('should keep memo unchanged when it has SDK prefix', () => {
-    const result = hyspSolana.testProcessMemo('SDK:bankxyz::prod:v1');
-
-    expect(new TextDecoder().decode(result.data)).toBe('SDK:bankxyz::prod:v1');
-  });
-});