The Solana Class

Solana is the main entry point. It wraps an RPC client and an IDL loader, and exposes everything you need for the most common on-chain operations.

Create an instance

import { Solana } from "solana-kiss";

const solana = new Solana("mainnet");           // public endpoint
const solana = new Solana("devnet");
const solana = new Solana("http://localhost:8899");

// Custom RPC with middleware
import { rpcHttpFromUrl, rpcHttpWithRetryOnError } from "solana-kiss";
const rpc = rpcHttpWithRetryOnError(
  rpcHttpFromUrl(new URL("https://my-rpc.example.com")),
  async ({ retriedCounter }) => retriedCounter < 3,
);
const solana = new Solana(rpc);

Optional constructor options:

Option	Default	Description
idlLoader	built-in chain	Override the IDL loading strategy
idlOverrides	—	Hard-code IDLs per program (useful in tests)
recentBlockHashCacheDurationMs	15000	How long to cache the latest block hash

Decode an account

const { accountState } = await solana.getAndInferAndDecodeAccount(accountAddress);

Fetches the account, auto-detects its type via the owning program's IDL, and decodes its binary state into a JSON value.

Build and send a transaction

prepareAndExecuteTransaction compiles, signs, sends, and waits for confirmation in a single call. It returns once the transaction is confirmed (or throws if the block hash expires).

import { signerFromSecret } from "solana-kiss";

const signer = await signerFromSecret(secretBytes);

// 1. Encode instruction (IDL-aware)
const { instructionRequest } = await solana.hydrateAndEncodeInstruction(
  programAddress,
  "transfer",
  {
    instructionAddresses: { source, destination, authority },
    instructionPayload: { amount: 1_000_000n },
  },
);

// 2. Compile + sign + send + confirm
const { transactionHandle, executionReport } =
  await solana.prepareAndExecuteTransaction(signer, [instructionRequest]);

if (executionReport.transactionError) {
  console.error("Failed:", executionReport.transactionError);
} else {
  console.log("Confirmed in slot", executionReport.blockSlot);
}

Simulate before sending

const { executionReport } = await solana.prepareAndSimulateTransaction(
  signer,
  [instructionRequest],
);

IDL access

// Load and cache a program's IDL
const { programIdl } = await solana.getOrLoadProgramIdl(programAddress);

// Pin a specific IDL for a program (bypasses the loader)
solana.setProgramIdlOverride(programAddress, myIdl);
solana.setProgramIdlOverride(programAddress, undefined); // remove

// Decode a raw instruction
const { instructionIdl, instructionAddresses, instructionPayload } =
  await solana.inferAndDecodeInstruction(instructionRequest);

PDAs

const pdaAddress = await solana.findPdaAddress(
  programAddress,
  "userAccount",
  { user: walletAddress },
);

Program-owned accounts

// accountName must match an account type defined in the program's IDL
const accounts = await solana.findProgramOwnedAccounts(
  programAddress,
  "UserAccount",
);

Access the underlying RPC client

const rpc = solana.getRpcHttp();