@epicentral/sos-sdk 0.6.1-alpha → 0.6.2-alpha

package/README.md

@@ -89,6 +89,22 @@ Additional modules:
 
 Borrow/repay for writers: use `buildOptionMintTransactionWithDerivation` (with vault/poolLoan) and `buildRepayPoolLoanFromCollateralInstruction` or `buildUnwindWriterUnsoldWithLoanRepayment`.
 
+### Transaction size and Address Lookup Tables
+
+Option mint (and buy/close) transactions exceed Solana's 1232-byte limit without compression. If you see **"encoding overruns Uint8Array"** when minting, pass `network` to `sendBuiltTransaction`:
+
+```ts
+await sendBuiltTransaction({
+  instructions: tx.instructions,
+  rpc,
+  rpcSubscriptions,
+  feePayer: walletSigner,
+  network: "devnet",  // or "mainnet" — auto-includes lookup table when configured
+});
+```
+
+Or pass `addressLookupTableAddresses: [getLookupTableAddressForNetwork("devnet")]` when non-null. Mainnet lookup table is `null` by default; create one via `yarn update:lookuptable` for mainnet.
+
 ### Token account closing (option mint and close long)
 
 - **Option mint (seller/writer):** After `option_mint`, all LONG tokens go to the pool escrow; the maker's LONG ATA is left with zero balance. The SDK **automatically appends an SPL CloseAccount instruction** (when `closeMakerLongAccount` is not set to `false`) so the maker reclaims rent. Use `buildOptionMintTransaction` or `buildOptionMintTransactionWithDerivation`; pass `closeMakerLongAccount: false` to skip closing the LONG ATA.

package/client/lookup-table.ts

@@ -10,7 +10,9 @@ export const LOOKUP_TABLE_ADDRESSES: Record<"devnet" | "mainnet", Address | null
 
 export const LOOKUP_TABLE_ADDRESS: Address | null = LOOKUP_TABLE_ADDRESSES.devnet;
 
-export function detectNetwork(rpcUrl: string): "devnet" | "mainnet" {
+export type LookupTableNetwork = "devnet" | "mainnet";
+
+export function detectNetwork(rpcUrl: string): LookupTableNetwork {
   const lower = rpcUrl.toLowerCase();
   return lower.includes("mainnet") ? "mainnet" : "devnet";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epicentral/sos-sdk",
-  "version": "0.6.1-alpha",
+  "version": "0.6.2-alpha",
   "private": false,
   "description": "Solana Option Standard SDK. The frontend-first SDK for Native Options Trading on Solana. Created by Epicentral Labs.",
   "type": "module",

package/shared/transactions.ts

@@ -21,6 +21,10 @@ import {
 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";
 
 export interface SendBuiltTransactionParams extends BuiltTransaction {
   rpc: KitRpc;
@@ -29,7 +33,18 @@ export interface SendBuiltTransactionParams extends BuiltTransaction {
   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;
 }
 
 /**
@@ -58,6 +73,15 @@ export async function sendBuiltTransaction(
   }
   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),
@@ -65,12 +89,9 @@ export async function sendBuiltTransaction(
     (tx) => appendTransactionMessageInstructions(allInstructions, tx)
   );
 
-  if (
-    params.addressLookupTableAddresses &&
-    params.addressLookupTableAddresses.length > 0
-  ) {
+  if (addressLookupTableAddresses.length > 0) {
     const addressesByAddressLookupTable: AddressesByLookupTableAddress = {};
-    for (const altAddress of params.addressLookupTableAddresses) {
+    for (const altAddress of addressLookupTableAddresses) {
       const resolvedAddress = toAddress(altAddress);
       const { data } = await fetchAddressLookupTable(params.rpc, resolvedAddress);
       addressesByAddressLookupTable[resolvedAddress] = data.addresses;