@nosana/kit 2.0.19 → 2.0.25

package/dist/services/{SolanaService.js → solana/SolanaService.js}

@@ -1,8 +1,9 @@
-import { createSolanaRpc, createSolanaRpcSubscriptions, address, getProgramDerivedAddress, getAddressEncoder, createTransactionMessage, signTransactionMessageWithSigners, getSignatureFromTransaction, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, sendAndConfirmTransactionFactory, appendTransactionMessageInstructions, pipe, assertIsSendableTransaction, } from '@solana/kit';
+import { createSolanaRpc, createSolanaRpcSubscriptions, address, getProgramDerivedAddress, getAddressEncoder, createTransactionMessage, signTransactionMessageWithSigners, partiallySignTransactionMessageWithSigners, getSignatureFromTransaction, setTransactionMessageFeePayer, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, sendAndConfirmTransactionFactory, appendTransactionMessageInstructions, pipe, assertIsSendableTransaction, getTransactionDecoder, getBase64Encoder, getBase64EncodedWireTransaction, isTransactionSigner, decompileTransactionMessage, getCompiledTransactionMessageDecoder, } from '@solana/kit';
 import { estimateComputeUnitLimitFactory, getSetComputeUnitLimitInstruction, } from '@solana-program/compute-budget';
 import { getCreateAssociatedTokenIdempotentInstructionAsync, TOKEN_PROGRAM_ADDRESS, } from '@solana-program/token';
-import { SYSTEM_PROGRAM_ADDRESS } from '@solana-program/system';
-import { NosanaError, ErrorCodes } from '../errors/NosanaError.js';
+import { SYSTEM_PROGRAM_ADDRESS, getTransferSolInstruction } from '@solana-program/system';
+import { NosanaError, ErrorCodes } from '../../errors/NosanaError.js';
+import { convertHttpToWebSocketUrl } from '../../utils/convertHttpToWebSocketUrl.js';
 /**
  * Factory function to create an estimateAndSetComputeUnitLimit function
  * that estimates compute units and adds the set compute unit limit instruction
@@ -22,8 +23,9 @@ export function createSolanaService(deps, config) {
         throw new NosanaError('RPC URL is required', ErrorCodes.INVALID_CONFIG);
     }
     const rpc = createSolanaRpc(config.rpcEndpoint);
-    // Use wsEndpoint if provided, otherwise fall back to rpcEndpoint
-    const rpcSubscriptions = createSolanaRpcSubscriptions(config.wsEndpoint ?? config.rpcEndpoint);
+    // Use wsEndpoint if provided, otherwise convert rpcEndpoint from http(s) to ws(s)
+    const wsUrl = config.wsEndpoint ?? convertHttpToWebSocketUrl(config.rpcEndpoint);
+    const rpcSubscriptions = createSolanaRpcSubscriptions(wsUrl);
     const sendAndConfirmTransaction = sendAndConfirmTransactionFactory({
         rpc,
         rpcSubscriptions,
@@ -90,7 +92,7 @@ export function createSolanaService(deps, config) {
                 }
                 deps.logger.debug(`Getting balance for address: ${addr}`);
                 const balance = await rpc.getBalance(addr).send();
-                return balance.value;
+                return Number(balance.value);
             }
             catch (error) {
                 if (error instanceof NosanaError) {
@@ -106,11 +108,14 @@ export function createSolanaService(deps, config) {
          * - Fee payer set to the provided feePayer, service feePayer, or wallet (in that order)
          * - Latest blockhash for lifetime
          * - Provided instructions
-         * - Estimated compute unit limit
+         * - Optionally: estimated compute unit limit
          *
          * @param instructions Single instruction or array of instructions
          * @param options Optional configuration
-         * @param options.feePayer Optional custom fee payer. Takes precedence over service feePayer and wallet.
+         * @param options.feePayer Optional custom fee payer. Can be a TransactionSigner (for full signing)
+         *                         or an Address/string (for partial signing where feepayer signs later).
+         *                         Takes precedence over service feePayer and wallet.
+         * @param options.estimateComputeUnits If true, estimates and sets the compute unit limit. Default: false.
          * @returns An unsigned transaction message ready to be signed
          */
         async buildTransaction(instructions, options) {
@@ -124,8 +129,22 @@ export function createSolanaService(deps, config) {
                 const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
                 // Normalize instructions to array
                 const instructionsArray = Array.isArray(instructions) ? instructions : [instructions];
+                // Helper to check if the feePayer is a TransactionSigner
+                const isSigner = (value) => typeof value === 'object' && isTransactionSigner(value);
                 // Build transaction message using pipe
-                const transactionMessage = await pipe(createTransactionMessage({ version: 0 }), (tx) => setTransactionMessageFeePayerSigner(transactionFeePayer, tx), (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), (tx) => appendTransactionMessageInstructions(instructionsArray, tx), (tx) => estimateAndSetComputeUnitLimit(tx));
+                // Use setTransactionMessageFeePayerSigner for TransactionSigner, setTransactionMessageFeePayer for Address
+                const transactionMessage = await pipe(createTransactionMessage({ version: 0 }), (tx) => {
+                    if (isSigner(transactionFeePayer)) {
+                        return setTransactionMessageFeePayerSigner(transactionFeePayer, tx);
+                    }
+                    else {
+                        // It's a string address, convert to Address type
+                        const feePayerAddress = address(transactionFeePayer);
+                        return setTransactionMessageFeePayer(feePayerAddress, tx);
+                    }
+                }, (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), (tx) => appendTransactionMessageInstructions(instructionsArray, tx), 
+                // Optionally estimate and set compute unit limit
+                (tx) => (options?.estimateComputeUnits ? estimateAndSetComputeUnitLimit(tx) : tx));
                 return transactionMessage;
             }
             catch (error) {
@@ -190,15 +209,54 @@ export function createSolanaService(deps, config) {
          * @param options Optional configuration
          * @param options.feePayer Optional custom fee payer. If not provided, uses the wallet.
          * @param options.commitment Commitment level for confirmation (takes precedence over config, then falls back to config.commitment, then 'confirmed')
+         * @param options.estimateComputeUnits If true, estimates and sets the compute unit limit. Default: false.
          * @returns The transaction signature
          */
         async buildSignAndSend(instructions, options) {
             const transactionMessage = await this.buildTransaction(instructions, {
                 feePayer: options?.feePayer,
+                estimateComputeUnits: options?.estimateComputeUnits,
             });
             const signedTransaction = await this.signTransaction(transactionMessage);
             return await this.sendTransaction(signedTransaction, { commitment: options?.commitment });
         },
+        /**
+         * Get an instruction to transfer SOL from one address to another.
+         *
+         * @param params Transfer parameters
+         * @param params.to Recipient address
+         * @param params.amount Amount in lamports (number or bigint)
+         * @param params.from Optional sender TransactionSigner. If not provided, uses wallet from client.
+         * @returns An instruction to transfer SOL
+         */
+        async transfer(params) {
+            try {
+                // Determine sender: use params.from if provided, otherwise get from wallet
+                const sender = params.from ?? deps.getWallet();
+                if (!sender) {
+                    throw new NosanaError('No wallet found and no from parameter provided', ErrorCodes.NO_WALLET);
+                }
+                // Convert amount to bigint if it's a number
+                const amountBigInt = typeof params.amount === 'bigint' ? params.amount : BigInt(params.amount);
+                // Convert recipient to Address
+                const recipient = typeof params.to === 'string' ? address(params.to) : params.to;
+                deps.logger.debug(`Creating SOL transfer instruction: ${amountBigInt} lamports from ${sender.address} to ${recipient}`);
+                // Create and return transfer instruction
+                const instruction = getTransferSolInstruction({
+                    source: sender,
+                    destination: recipient,
+                    amount: amountBigInt,
+                });
+                return instruction;
+            }
+            catch (error) {
+                if (error instanceof NosanaError) {
+                    throw error;
+                }
+                deps.logger.error(`Failed to get transfer SOL instruction: ${error}`);
+                throw new NosanaError('Failed to get transfer SOL instruction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
         /**
          * Get an instruction to create an associated token account if it doesn't exist.
          * Checks if the ATA exists, and if not, returns an instruction to create it.
@@ -239,6 +297,130 @@ export function createSolanaService(deps, config) {
                 throw new NosanaError('Failed to get create ATA instruction', ErrorCodes.RPC_ERROR, error);
             }
         },
+        /**
+         * Partially sign a transaction message with the signers embedded in the transaction.
+         * The transaction message must already have a fee payer address set (via buildTransaction with an address).
+         * Signers are extracted from instructions in the message (e.g., transfer source signer).
+         * Use this when building transactions where the fee payer will sign later.
+         *
+         * @param transactionMessage The transaction message to sign (must have fee payer address set and signers embedded in instructions)
+         * @returns A partially signed transaction
+         */
+        async partiallySignTransaction(transactionMessage) {
+            try {
+                deps.logger.debug('Partially signing transaction with embedded signers');
+                // Use partiallySignTransactionMessageWithSigners to sign with signers embedded in the message
+                const partiallySignedTransaction = await partiallySignTransactionMessageWithSigners(transactionMessage);
+                return partiallySignedTransaction;
+            }
+            catch (error) {
+                deps.logger.error(`Failed to partially sign transaction: ${error}`);
+                throw new NosanaError('Failed to partially sign transaction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
+        /**
+         * Serialize a transaction to a base64 string.
+         * Works with both partially signed and fully signed transactions.
+         * Use this to transmit transactions to other parties (e.g., for fee payer signing).
+         *
+         * @param transaction The transaction to serialize
+         * @returns Base64 encoded wire transaction string
+         */
+        serializeTransaction(transaction) {
+            try {
+                deps.logger.debug('Serializing transaction to base64');
+                // Use getBase64EncodedWireTransaction to encode the transaction
+                const base64String = getBase64EncodedWireTransaction(transaction);
+                return base64String;
+            }
+            catch (error) {
+                deps.logger.error(`Failed to serialize transaction: ${error}`);
+                throw new NosanaError('Failed to serialize transaction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
+        /**
+         * Deserialize a base64 string back to a transaction.
+         * Use this to receive transactions from other parties.
+         *
+         * @param base64 The base64 encoded transaction string
+         * @returns The deserialized transaction
+         */
+        deserializeTransaction(base64) {
+            try {
+                deps.logger.debug('Deserializing transaction from base64');
+                // Decode the base64 string to bytes, then to transaction
+                const transactionBytes = getBase64Encoder().encode(base64);
+                const transaction = getTransactionDecoder().decode(transactionBytes);
+                return transaction;
+            }
+            catch (error) {
+                deps.logger.error(`Failed to deserialize transaction: ${error}`);
+                throw new NosanaError('Failed to deserialize transaction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
+        /**
+         * Sign a transaction with the provided signers.
+         * Use this when receiving a partially signed transaction that needs additional signatures.
+         * This adds signatures from the provided signers to the transaction.
+         *
+         * @param transaction The transaction to sign (typically partially signed, received from another party)
+         * @param signers Array of TransactionPartialSigners to sign with
+         * @returns The signed transaction with additional signatures
+         */
+        async signTransactionWithSigners(transaction, signers) {
+            try {
+                deps.logger.debug(`Signing transaction with ${signers.length} signer(s): ${signers.map((s) => s.address).join(', ')}`);
+                // Sign with each signer and merge signatures into the transaction
+                // TransactionPartialSigner.signTransactions returns SignatureDictionary[] (not transactions)
+                // We need to merge these signatures into the transaction's signatures map
+                let updatedSignatures = { ...transaction.signatures };
+                for (const signer of signers) {
+                    // signTransactions returns an array of SignatureDictionary (one per transaction)
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const [signatureDict] = await signer.signTransactions([transaction]);
+                    // Merge the new signatures into our accumulated signatures
+                    updatedSignatures = { ...updatedSignatures, ...signatureDict };
+                }
+                // Create a new transaction with the merged signatures
+                const signedTransaction = {
+                    ...transaction,
+                    signatures: updatedSignatures,
+                };
+                return signedTransaction;
+            }
+            catch (error) {
+                if (error instanceof NosanaError) {
+                    throw error;
+                }
+                deps.logger.error(`Failed to sign transaction: ${error}`);
+                throw new NosanaError('Failed to sign transaction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
+        /**
+         * Decompile a transaction back to a transaction message.
+         * Use this to inspect/verify the content of a deserialized transaction before signing.
+         *
+         * Note: Decompilation is lossy - some information like lastValidBlockHeight may not be fully
+         * reconstructed. The returned message is suitable for inspection but may not be suitable
+         * for re-signing without additional context.
+         *
+         * @param transaction The compiled transaction to decompile
+         * @returns The decompiled transaction message (with either blockhash or durable nonce lifetime)
+         */
+        decompileTransaction(transaction) {
+            try {
+                deps.logger.debug('Decompiling transaction to transaction message');
+                // First decode the compiled transaction message from the transaction bytes
+                const compiledMessage = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);
+                // Then decompile to get the transaction message
+                const transactionMessage = decompileTransactionMessage(compiledMessage);
+                return transactionMessage;
+            }
+            catch (error) {
+                deps.logger.error(`Failed to decompile transaction: ${error}`);
+                throw new NosanaError('Failed to decompile transaction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
     };
 }
 //# sourceMappingURL=SolanaService.js.map

package/dist/services/solana/SolanaService.js.map

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

package/dist/services/solana/index.d.ts

@@ -0,0 +1 @@
+export * from './SolanaService.js';

package/dist/services/solana/index.js

@@ -0,0 +1,2 @@
+export * from './SolanaService.js';
+//# sourceMappingURL=index.js.map

package/dist/services/solana/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/solana/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/services/token/TokenService.d.ts

@@ -0,0 +1,65 @@
+import { Address, Instruction, TransactionSigner } from '@solana/kit';
+import { Logger } from '../../logger/Logger.js';
+import { Wallet } from '../../types.js';
+export interface TokenAccount {
+    pubkey: Address;
+    owner: Address;
+    mint: Address;
+    amount: bigint;
+    decimals: number;
+}
+export interface TokenAccountWithBalance extends TokenAccount {
+    uiAmount: number;
+}
+import type { SolanaService } from '../solana/index.js';
+/**
+ * Dependencies for TokenService
+ */
+export interface TokenServiceDeps {
+    logger: Logger;
+    solana: SolanaService;
+    getWallet: () => Wallet | undefined;
+}
+/**
+ * Config for TokenService
+ */
+export interface TokenServiceConfig {
+    tokenAddress: Address;
+}
+/**
+ * TokenService interface
+ */
+export interface TokenService {
+    getAllTokenHolders(options?: {
+        includeZeroBalance?: boolean;
+        excludePdaAccounts?: boolean;
+    }): Promise<TokenAccountWithBalance[]>;
+    getTokenAccountForAddress(owner: string | Address): Promise<TokenAccountWithBalance | null>;
+    getBalance(owner?: string | Address): Promise<number>;
+    /**
+     * Get the associated token account address for a given owner.
+     *
+     * @param owner The owner address
+     * @returns The associated token account address
+     */
+    getATA(owner: Address | string): Promise<Address>;
+    /**
+     * Get instruction(s) to transfer SPL tokens from one address to another.
+     * May return 1 or 2 instructions depending on whether the recipient's associated token account needs to be created.
+     *
+     * @param params Transfer parameters
+     * @param params.to Recipient address
+     * @param params.amount Amount in token base units (number or bigint)
+     * @param params.from Optional sender TransactionSigner. If not provided, uses wallet from client.
+     * @returns Array of instructions (create ATA instruction if needed, then transfer instruction)
+     */
+    transfer(params: {
+        to: Address | string;
+        amount: number | bigint;
+        from?: TransactionSigner;
+    }): Promise<Instruction[]>;
+}
+/**
+ * Creates a TokenService instance.
+ */
+export declare function createTokenService(deps: TokenServiceDeps, config: TokenServiceConfig): TokenService;

package/dist/services/{TokenService.js → token/TokenService.js}

@@ -1,6 +1,6 @@
 import { address } from '@solana/kit';
-import { NosanaError, ErrorCodes } from '../errors/NosanaError.js';
-import { TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
+import { NosanaError, ErrorCodes } from '../../errors/NosanaError.js';
+import { TOKEN_PROGRAM_ADDRESS, getTransferInstruction, findAssociatedTokenPda, } from '@solana-program/token';
 // Standard SPL token account size
 const TOKEN_ACCOUNT_SIZE = 165;
 // Offset of mint address in token account data structure
@@ -124,13 +124,91 @@ export function createTokenService(deps, config) {
          * Get the token balance for a specific owner address
          * Convenience method that returns just the balance
          *
-         * @param owner - The owner address to query
+         * @param owner - Optional owner address to query. If not provided, uses the wallet address.
          * @returns The token balance as a UI amount (with decimals), or 0 if no account exists
+         * @throws {NosanaError} If neither owner nor wallet is provided
          */
         async getBalance(owner) {
-            const account = await this.getTokenAccountForAddress(owner);
+            let ownerAddr;
+            if (owner) {
+                ownerAddr = typeof owner === 'string' ? address(owner) : owner;
+            }
+            else {
+                const wallet = deps.getWallet();
+                if (!wallet) {
+                    throw new NosanaError('No wallet found and no owner address provided', ErrorCodes.NO_WALLET);
+                }
+                ownerAddr = wallet.address;
+            }
+            const account = await this.getTokenAccountForAddress(ownerAddr);
             return account ? account.uiAmount : 0;
         },
+        /**
+         * Get the associated token account address for a given owner.
+         *
+         * @param owner The owner address
+         * @returns The associated token account address
+         */
+        async getATA(owner) {
+            const ownerAddr = typeof owner === 'string' ? address(owner) : owner;
+            const tokenMint = config.tokenAddress;
+            const [ata] = await findAssociatedTokenPda({
+                mint: tokenMint,
+                owner: ownerAddr,
+                tokenProgram: TOKEN_PROGRAM_ADDRESS,
+            });
+            return ata;
+        },
+        /**
+         * Get instruction(s) to transfer SPL tokens from one address to another.
+         * May return 1 or 2 instructions depending on whether the recipient's associated token account needs to be created.
+         *
+         * @param params Transfer parameters
+         * @param params.to Recipient address
+         * @param params.amount Amount in token base units (number or bigint)
+         * @param params.from Optional sender TransactionSigner. If not provided, uses wallet from client.
+         * @returns Array of instructions (create ATA instruction if needed, then transfer instruction)
+         */
+        async transfer(params) {
+            try {
+                // Determine sender: use params.from if provided, otherwise use wallet
+                const sender = params.from ?? deps.getWallet();
+                if (!sender) {
+                    throw new NosanaError('No wallet found and no from parameter provided', ErrorCodes.NO_WALLET);
+                }
+                // Convert amount to bigint if it's a number
+                const amountBigInt = typeof params.amount === 'bigint' ? params.amount : BigInt(params.amount);
+                // Convert recipient to Address
+                const recipient = typeof params.to === 'string' ? address(params.to) : params.to;
+                const tokenMint = config.tokenAddress;
+                deps.logger.debug(`Creating SPL token transfer instruction: ${amountBigInt} tokens from ${sender.address} to ${recipient}`);
+                // Find sender's ATA
+                const senderAta = await this.getATA(sender.address);
+                // Find recipient's ATA
+                const recipientAta = await this.getATA(recipient);
+                // Check if recipient ATA exists and get create instruction if needed
+                const createAtaInstruction = await deps.solana.getCreateATAInstructionIfNeeded(recipientAta, tokenMint, recipient, sender);
+                // Create transfer instruction
+                const transferIx = getTransferInstruction({
+                    source: senderAta,
+                    destination: recipientAta,
+                    authority: sender.address,
+                    amount: amountBigInt,
+                });
+                // Return array of instructions - either 1 or 2 instructions
+                if (createAtaInstruction) {
+                    return [createAtaInstruction, transferIx];
+                }
+                return [transferIx];
+            }
+            catch (error) {
+                if (error instanceof NosanaError) {
+                    throw error;
+                }
+                deps.logger.error(`Failed to get transfer instruction: ${error}`);
+                throw new NosanaError('Failed to get transfer instruction', ErrorCodes.TRANSACTION_ERROR, error);
+            }
+        },
     };
 }
 //# sourceMappingURL=TokenService.js.map

package/dist/services/token/TokenService.js.map

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

package/dist/services/token/index.d.ts

@@ -0,0 +1 @@
+export * from './TokenService.js';

package/dist/services/token/index.js

@@ -0,0 +1,2 @@
+export * from './TokenService.js';
+//# sourceMappingURL=index.js.map

package/dist/services/token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/token/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 import { TransactionSigner, MessageSigner } from '@solana/kit';
-import type { SolanaService } from './services/SolanaService.js';
+import type { SolanaService } from './services/solana/index.js';
+import type { TokenService } from './services/token/index.js';
 import { Logger } from './logger/Logger.js';
 /**
  * A wallet that can sign both messages and transactions.
@@ -13,5 +14,6 @@ export type Wallet = MessageSigner & TransactionSigner;
 export interface ProgramDeps {
     logger: Logger;
     solana: SolanaService;
+    nos: TokenService;
     getWallet: () => Wallet | undefined;
 }

package/dist/utils/convertHttpToWebSocketUrl.d.ts

@@ -0,0 +1,28 @@
+/**
+ * URL protocol constants
+ */
+export declare const PROTOCOL: {
+    readonly HTTP: "http";
+    readonly HTTPS: "https";
+    readonly WS: "ws";
+    readonly WSS: "wss";
+};
+/**
+ * Converts an HTTP/HTTPS URL to a WebSocket URL (ws/wss).
+ * Replaces the protocol: http -> ws, https -> wss
+ *
+ * @param httpUrl The HTTP or HTTPS URL to convert
+ * @returns The WebSocket URL with the protocol replaced
+ * @throws NosanaError if the URL doesn't use HTTP/HTTPS protocol
+ * @throws TypeError if the URL is invalid
+ *
+ * @example
+ * ```ts
+ * convertHttpToWebSocketUrl('https://api.mainnet-beta.solana.com')
+ * // Returns: 'wss://api.mainnet-beta.solana.com'
+ *
+ * convertHttpToWebSocketUrl('http://localhost:8899')
+ * // Returns: 'ws://localhost:8899'
+ * ```
+ */
+export declare function convertHttpToWebSocketUrl(httpUrl: string): string;

package/dist/utils/convertHttpToWebSocketUrl.js

@@ -0,0 +1,37 @@
+import { NosanaError, ErrorCodes } from '../errors/NosanaError.js';
+/**
+ * URL protocol constants
+ */
+export const PROTOCOL = {
+    HTTP: 'http',
+    HTTPS: 'https',
+    WS: 'ws',
+    WSS: 'wss',
+};
+/**
+ * Converts an HTTP/HTTPS URL to a WebSocket URL (ws/wss).
+ * Replaces the protocol: http -> ws, https -> wss
+ *
+ * @param httpUrl The HTTP or HTTPS URL to convert
+ * @returns The WebSocket URL with the protocol replaced
+ * @throws NosanaError if the URL doesn't use HTTP/HTTPS protocol
+ * @throws TypeError if the URL is invalid
+ *
+ * @example
+ * ```ts
+ * convertHttpToWebSocketUrl('https://api.mainnet-beta.solana.com')
+ * // Returns: 'wss://api.mainnet-beta.solana.com'
+ *
+ * convertHttpToWebSocketUrl('http://localhost:8899')
+ * // Returns: 'ws://localhost:8899'
+ * ```
+ */
+export function convertHttpToWebSocketUrl(httpUrl) {
+    const url = new URL(httpUrl);
+    if (!url.protocol.match(/^https?:$/i)) {
+        throw new NosanaError(`Unsupported protocol: ${url.protocol}. Only HTTP and HTTPS are supported.`, ErrorCodes.VALIDATION_ERROR);
+    }
+    url.protocol = url.protocol.replace(PROTOCOL.HTTP, PROTOCOL.WS);
+    return url.toString();
+}
+//# sourceMappingURL=convertHttpToWebSocketUrl.js.map

package/dist/utils/convertHttpToWebSocketUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertHttpToWebSocketUrl.js","sourceRoot":"","sources":["../../src/utils/convertHttpToWebSocketUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;CACF,CAAC;AAEX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAE7B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,WAAW,CACnB,yBAAyB,GAAG,CAAC,QAAQ,sCAAsC,EAC3E,UAAU,CAAC,gBAAgB,CAC5B,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/utils/getStaticAccounts.d.ts

@@ -1,5 +1,5 @@
 import { Address } from '@solana/kit';
-import type { SolanaService } from '../services/SolanaService.js';
+import type { SolanaService } from '../services/solana/index.js';
 import type { ProgramConfig } from '../config/types.js';
 export type StaticAccounts = {
     rewardsReflection: Address;

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from './convertBigIntToNumber.js';
+export * from './convertHttpToWebSocketUrl.js';
 export * from './getStaticAccounts.js';
 export * from './walletToAuthorizationSigner.js';

package/dist/utils/index.js

@@ -1,5 +1,6 @@
 // Barrel export file - exports all utility functions and types
 export * from './convertBigIntToNumber.js';
+export * from './convertHttpToWebSocketUrl.js';
 export * from './getStaticAccounts.js';
 export * from './walletToAuthorizationSigner.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@nosana/kit",
-  "version": "2.0.19",
+  "version": "2.0.25",
   "description": "Nosana KIT",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
+    "test": "NODE_NO_WARNINGS=1 vitest run",
+    "test:coverage": "NODE_NO_WARNINGS=1 vitest run --coverage",
+    "test:watch": "NODE_NO_WARNINGS=1 vitest",
     "generate-clients": "npx tsx scripts/generate-clients.ts",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",