@epicentral/sos-sdk 0.2.10 → 0.2.12

package/index.ts

@@ -34,3 +34,5 @@ export {
   getCreateAssociatedTokenIdempotentInstructionWithAddress,
   NATIVE_MINT,
 } from "./wsol/instructions";
+
+export { getCreateEscrowV2InstructionAsync } from "./generated/instructions/createEscrowV2";

package/long/builders.ts

@@ -17,6 +17,7 @@ import {
   type RemainingAccountInput,
 } from "../shared/remaining-accounts";
 import type { OptionType } from "../generated/types";
+import { getCreateAssociatedTokenIdempotentInstructionWithAddress } from "../wsol/instructions";
 
 export interface BuildBuyFromPoolParams {
   optionPool: AddressLike;
@@ -85,11 +86,28 @@ export async function buildBuyFromPoolInstruction(
   return appendRemainingAccounts(kitInstruction, params.remainingAccounts);
 }
 
+/**
+ * Builds a buy-from-pool transaction. The returned transaction may include a
+ * leading create-ATA-idempotent instruction for the buyer's option account so
+ * first-time buyers succeed without a separate setup step.
+ */
 export async function buildBuyFromPoolTransaction(
   params: BuildBuyFromPoolParams
 ): Promise<BuiltTransaction> {
-  const instruction = await buildBuyFromPoolInstruction(params);
-  return { instructions: [instruction] };
+  const buyerOptionAccountAddress = params.buyerOptionAccount
+    ? toAddress(params.buyerOptionAccount)
+    : await deriveAssociatedTokenAddress(params.buyer, params.longMint);
+
+  const createAtaIx =
+    await getCreateAssociatedTokenIdempotentInstructionWithAddress(
+      params.buyer,
+      params.buyer,
+      params.longMint,
+      buyerOptionAccountAddress
+    );
+
+  const buyFromPoolIx = await buildBuyFromPoolInstruction(params);
+  return { instructions: [createAtaIx, buyFromPoolIx] };
 }
 
 export interface BuildBuyFromPoolTransactionWithDerivationParams {

package/package.json

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

package/short/builders.ts

@@ -200,6 +200,7 @@ export interface BuildOptionMintTransactionWithDerivationParams {
   makerCollateralAmount: bigint | number;
   borrowedAmount: bigint | number;
   maker: AddressLike;
+  /** Optional. When omitted, the SDK derives the maker's collateral ATA for underlyingMint. */
   makerCollateralAccount?: AddressLike;
   rpc: KitRpc;
   programId?: AddressLike;