@epicentral/sos-sdk 0.12.1-beta → 0.12.2-beta

package/long/builders.ts

@@ -110,10 +110,12 @@ export interface BuildCloseLongToPoolParams {
    */
   closeLongTokenAccount?: boolean;
   /**
-   * When true and underlying is WSOL, appends an SPL CloseAccount to unwrap the payout ATA so the buyer receives native SOL.
-   * Ignored when underlyingMint is not WSOL.
+   * When true and settlement is physical (collateral mint == underlying) with WSOL underlying,
+   * appends CloseAccount to unwrap the payout WSOL ATA to native SOL.
    */
   unwrapPayoutSol?: boolean;
+  /** When false, skips idempotent create-ATA for payout accounts (default: true). */
+  createPayoutAtas?: boolean;
   remainingAccounts?: RemainingAccountInput[];
 }
 
@@ -554,10 +556,36 @@ export async function buildCloseLongToPoolInstruction(
 }
 
 export async function buildCloseLongToPoolTransaction(
-  params: BuildCloseLongToPoolParams
+  params: BuildCloseLongToPoolParams & { createPayoutAtas?: boolean }
 ): Promise<BuiltTransaction> {
+  const collateralMint = params.collateralMint ?? params.underlyingMint;
+  const isPhysicalSettlement =
+    toAddress(collateralMint) === toAddress(params.underlyingMint);
+  const instructions: Instruction<string>[] = [];
+
+  if (params.createPayoutAtas !== false) {
+    instructions.push(
+      await getCreateAssociatedTokenIdempotentInstructionWithAddress(
+        params.buyer,
+        params.buyer,
+        toAddress(collateralMint),
+        toAddress(params.buyerPayoutAccount)
+      )
+    );
+    if (!isPhysicalSettlement) {
+      instructions.push(
+        await getCreateAssociatedTokenIdempotentInstructionWithAddress(
+          params.buyer,
+          params.buyer,
+          toAddress(params.underlyingMint),
+          toAddress(params.buyerUnderlyingPayoutAccount)
+        )
+      );
+    }
+  }
+
   const instruction = await buildCloseLongToPoolInstruction(params);
-  const instructions = [instruction];
+  instructions.push(instruction);
 
   if (params.closeLongTokenAccount === true) {
     instructions.push(
@@ -609,10 +637,12 @@ export interface BuildCloseLongToPoolTransactionWithDerivationParams {
    */
   closeLongTokenAccount?: boolean;
   /**
-   * When true (default for WSOL underlying), appends CloseAccount to unwrap payout WSOL ATA to native SOL.
-   * Only applies when option underlying is WSOL.
+   * When true, unwraps physical-settlement WSOL payout to native SOL after close.
+   * Defaults to true only for physical WSOL pools; cash-settled pools default to false.
    */
   unwrapPayoutSol?: boolean;
+  /** When false, skips idempotent create-ATA for payout accounts (default: true). */
+  createPayoutAtas?: boolean;
   remainingAccounts?: RemainingAccountInput[];
   disableSwitchboardCrank?: boolean;
   switchboardCrossbarUrl?: string;
@@ -665,10 +695,13 @@ export async function buildCloseLongToPoolTransactionWithDerivation(
 
   const isWsolUnderlying =
     toAddress(resolved.underlyingMint!) === toAddress(NATIVE_MINT);
+  const isPhysicalSettlement =
+    toAddress(collateralMint) === toAddress(resolved.underlyingMint!);
   const closeLongTokenAccount =
     params.closeLongTokenAccount !== false;
   const unwrapPayoutSol =
-    params.unwrapPayoutSol !== false && isWsolUnderlying;
+    params.unwrapPayoutSol ??
+    (isWsolUnderlying && isPhysicalSettlement);
 
   // close_long_to_pool requires a complete set of active WriterPositions so the
   // program can run the strict Hamilton completeness check. Auto-populate if
@@ -716,6 +749,7 @@ export async function buildCloseLongToPoolTransactionWithDerivation(
       buyerPosition,
       closeLongTokenAccount,
       unwrapPayoutSol,
+      createPayoutAtas: params.createPayoutAtas,
       remainingAccounts,
     });
   }
@@ -755,6 +789,7 @@ export async function buildCloseLongToPoolTransactionWithDerivation(
     buyerPosition,
     closeLongTokenAccount,
     unwrapPayoutSol,
+    createPayoutAtas: params.createPayoutAtas,
     remainingAccounts,
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epicentral/sos-sdk",
-  "version": "0.12.1-beta",
+  "version": "0.12.2-beta",
   "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/preflight.ts

@@ -252,9 +252,10 @@ export async function preflightUnwindWriterUnsold(
   const collateralPoolData = resolved.collateralPoolData;
 
   const underlyingMint = params.underlyingMint ?? resolved.underlyingMint;
-  const [vaultPda] = await deriveVaultPda(underlyingMint, params.programId);
+  const collateralMint = collateralPoolData.collateralMint ?? underlyingMint;
+  const [vaultPda] = await deriveVaultPda(collateralMint, params.programId);
   const vaultPdaAddress = toAddress(vaultPda);
-  const writerDefaultRepaymentAta = await deriveAssociatedTokenAddress(params.writer, underlyingMint);
+  const writerDefaultRepaymentAta = await deriveAssociatedTokenAddress(params.writer, collateralMint);
   // `writerRepaymentAccount` stays in the result for ABI compatibility with
   // existing callers (e.g. wallet-fallback UX from pre-convergence), but it
   // is not used on-chain anymore.