Solana Service

General Solana utility service for low-level RPC operations, transactions, and PDA derivations.

Methods

Build, Sign, and Send (Convenience Method)

buildSignAndSend(
  instructions: Instruction | Instruction[],
  options?: {
    feePayer?: TransactionSigner;
    commitment?: 'processed' | 'confirmed' | 'finalized';
  }
): Promise<Signature>

Build Transaction

buildTransaction(
  instructions: Instruction | Instruction[],
  options?: { feePayer?: TransactionSigner }
): Promise<TransactionMessage & TransactionMessageWithFeePayer & TransactionMessageWithBlockhashLifetime>

Sign Transaction

signTransaction(
  transactionMessage: TransactionMessage & TransactionMessageWithFeePayer & TransactionMessageWithBlockhashLifetime
): Promise<SendableTransaction & Transaction & TransactionWithBlockhashLifetime>

Send Transaction

sendTransaction(
  transaction: SendableTransaction & Transaction & TransactionWithBlockhashLifetime,
  options?: { commitment?: 'processed' | 'confirmed' | 'finalized' }
): Promise<Signature>

Get Balance

getBalance(address?: Address | string): Promise<bigint>

Derive PDA

pda(seeds: Array<Address | string>, programId: Address): Promise<Address>

Transfer SOL

transfer(params: {
  to: Address | string;
  amount: number | bigint;
  from?: TransactionSigner;
}): Promise<Instruction> // Returns TransferSolInstruction

Examples

import type { Signature } from '@solana/kit';
import type { Address } from '@nosana/kit';

// Send a single instruction (convenience method)
const signature: Signature = await client.solana.buildSignAndSend(instruction);

// Send multiple instructions atomically
const signature2: Signature = await client.solana.buildSignAndSend([ix1, ix2, ix3]);

// Or build, sign, and send separately for more control
const transactionMessage = await client.solana.buildTransaction(instruction);
const signedTransaction = await client.solana.signTransaction(transactionMessage);
const signature3: Signature = await client.solana.sendTransaction(signedTransaction);

// Check account balance
const balance: number = await client.solana.getBalance(address('address'));
console.log(`Balance: ${balance} lamports`);

// Derive PDA
const pda: Address = await client.solana.pda(['seed1', 'seed2'], programAddress);

// Get instruction to transfer SOL
const transferSolIx: Instruction = await client.solana.transfer({
  to: address('recipient-address'),
  amount: 1000000, // lamports (can be number or bigint)
  // from is optional - uses wallet if not provided
});

// Execute the transfer
await client.solana.buildSignAndSend(transferSolIx);