@epicentral/sos-sdk 0.9.0-beta

package/shared/transactions.ts

@@ -0,0 +1,121 @@
+import {
+  appendTransactionMessageInstructions,
+  compressTransactionMessageUsingAddressLookupTables,
+  createTransactionMessage,
+  getSignatureFromTransaction,
+  pipe,
+  sendAndConfirmTransactionFactory,
+  setTransactionMessageFeePayerSigner,
+  setTransactionMessageLifetimeUsingBlockhash,
+  signTransactionMessageWithSigners,
+  type AddressesByLookupTableAddress,
+  type RpcSubscriptions,
+  type SolanaRpcSubscriptionsApi,
+  type TransactionSigner,
+} from "@solana/kit";
+import { fetchAddressLookupTable } from "@solana-program/address-lookup-table";
+import {
+  getSetComputeUnitLimitInstruction,
+  getSetComputeUnitPriceInstruction,
+} from "@solana-program/compute-budget";
+import type { Instruction } from "@solana/kit";
+import { toAddress } from "../client/program";
+import type { AddressLike, BuiltTransaction, KitRpc } from "../client/types";
+import {
+  getLookupTableAddressForNetwork,
+  type LookupTableNetwork,
+} from "../client/lookup-table";
+import { getGlobalTradeConfig } from "./trade-config";
+
+export interface SendBuiltTransactionParams extends BuiltTransaction {
+  rpc: KitRpc;
+  rpcSubscriptions: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+  feePayer: TransactionSigner<string>;
+  commitment?: "processed" | "confirmed" | "finalized";
+  computeUnitLimit?: number;
+  computeUnitPriceMicroLamports?: number;
+  /**
+   * Address Lookup Table addresses to compress the transaction.
+   * REQUIRED for option_mint and other large transactions to avoid
+   * "encoding overruns Uint8Array" (Solana's 1232-byte tx limit).
+   * Use getLookupTableAddressForNetwork(network) or pass network to auto-include.
+   */
+  addressLookupTableAddresses?: AddressLike[];
+  /**
+   * When set, automatically includes the option program's lookup table for this network.
+   * Use this when sending option_mint, buy_from_pool, or other large transactions.
+   */
+  network?: LookupTableNetwork;
+}
+
+/**
+ * Sends a built SDK transaction with common Solana Kit defaults.
+ * The caller still controls the RPC clients and fee-payer signer.
+ * Supports optional compute budget (limit + priority fee) and ALT compression.
+ */
+export async function sendBuiltTransaction(
+  params: SendBuiltTransactionParams
+): Promise<string> {
+  const commitment = params.commitment ?? "confirmed";
+  const globalTradeConfig = getGlobalTradeConfig();
+  const { value: latestBlockhash } = await params.rpc.getLatestBlockhash().send();
+
+  const computeBudgetInstructions: Instruction<string>[] = [];
+  const computeUnitLimit =
+    params.computeUnitLimit ?? globalTradeConfig.computeUnitLimit;
+  if (computeUnitLimit !== undefined) {
+    computeBudgetInstructions.push(
+      getSetComputeUnitLimitInstruction({ units: computeUnitLimit })
+    );
+  }
+  const computeUnitPriceMicroLamports =
+    params.computeUnitPriceMicroLamports ??
+    globalTradeConfig.computeUnitPriceMicroLamports;
+  if (computeUnitPriceMicroLamports !== undefined) {
+    computeBudgetInstructions.push(
+      getSetComputeUnitPriceInstruction({
+        microLamports: computeUnitPriceMicroLamports,
+      })
+    );
+  }
+  const allInstructions = [...computeBudgetInstructions, ...params.instructions];
+
+  // Resolve address lookup tables: explicit list, or from network for option program
+  let addressLookupTableAddresses = params.addressLookupTableAddresses ?? [];
+  if (params.network) {
+    const programAlt = getLookupTableAddressForNetwork(params.network);
+    if (programAlt && !addressLookupTableAddresses.some((a) => String(a) === String(programAlt))) {
+      addressLookupTableAddresses = [programAlt, ...addressLookupTableAddresses];
+    }
+  }
+
+  let txMessage = pipe(
+    createTransactionMessage({ version: 0 }),
+    (tx) => setTransactionMessageFeePayerSigner(params.feePayer, tx),
+    (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx),
+    (tx) => appendTransactionMessageInstructions(allInstructions, tx)
+  );
+
+  if (addressLookupTableAddresses.length > 0) {
+    const addressesByAddressLookupTable: AddressesByLookupTableAddress = {};
+    for (const altAddress of addressLookupTableAddresses) {
+      const resolvedAddress = toAddress(altAddress);
+      const { data } = await fetchAddressLookupTable(params.rpc, resolvedAddress);
+      addressesByAddressLookupTable[resolvedAddress] = data.addresses;
+    }
+    txMessage = compressTransactionMessageUsingAddressLookupTables(
+      txMessage,
+      addressesByAddressLookupTable
+    );
+  }
+
+  const signedTx = await signTransactionMessageWithSigners(txMessage);
+  const sendAndConfirm = sendAndConfirmTransactionFactory({
+    rpc: params.rpc,
+    rpcSubscriptions: params.rpcSubscriptions,
+  });
+  type SendableTransaction = Parameters<typeof sendAndConfirm>[0];
+
+  await sendAndConfirm(signedTx as SendableTransaction, { commitment });
+  return getSignatureFromTransaction(signedTx);
+}