@epicentral/sos-sdk 0.2.11 → 0.2.13

package/accounts/list.ts

@@ -27,6 +27,8 @@ import type { AddressLike, KitRpc } from "../client/types";
 
 const DISCRIMINATOR_OFFSET = 0n;
 const OWNER_OFFSET = 8n;
+/** WriterPosition layout: discriminator(8) + writer_authority(32) + option_pool(32). Used for getProgramAccounts memcmp. */
+const WRITER_POSITION_OPTION_POOL_OFFSET = 40n;
 const ACTIVE_POOL_LOAN_STATUS = 1;
 
 type ListedAccount<T> = {
@@ -68,13 +70,24 @@ function ownerFilter(owner: AddressLike) {
   } as const;
 }
 
+function optionPoolFilter(optionPool: AddressLike) {
+  return {
+    memcmp: {
+      offset: WRITER_POSITION_OPTION_POOL_OFFSET,
+      encoding: "base58",
+      bytes: toAddress(optionPool),
+    },
+  } as const;
+}
+
 async function fetchAndDecodeProgramAccounts<T>(
   rpc: KitRpc,
   decoder: { decode: (value: Uint8Array) => T },
-  filters: ReadonlyArray<unknown>
+  filters: ReadonlyArray<unknown>,
+  programAddress: AddressLike = PROGRAM_ID
 ): Promise<Array<ListedAccount<T>>> {
   const response = await rpc
-    .getProgramAccounts(PROGRAM_ID, {
+    .getProgramAccounts(toAddress(programAddress), {
       encoding: "base64",
       filters: filters as never,
     })
@@ -105,6 +118,27 @@ export async function fetchWriterPositionsByWriter(
   ]);
 }
 
+/**
+ * Fetches all WriterPosition accounts for a single option pool.
+ * WriterPosition layout: option_pool at offset 40, 32 bytes (memcmp filter).
+ */
+export async function fetchWriterPositionsForPool(
+  rpc: KitRpc,
+  optionPool: AddressLike,
+  programId?: AddressLike
+): Promise<Array<ListedAccount<WriterPosition>>> {
+  return fetchAndDecodeProgramAccounts(
+    rpc,
+    getWriterPositionDecoder(),
+    [
+      discriminatorFilter(WRITER_POSITION_DISCRIMINATOR),
+      optionPoolFilter(optionPool),
+      { dataSize: BigInt(getWriterPositionSize()) },
+    ],
+    programId ?? PROGRAM_ID
+  );
+}
+
 export async function fetchPositionAccountsByBuyer(
   rpc: KitRpc,
   buyer: AddressLike

package/index.ts

@@ -17,6 +17,9 @@ export * from "./shared/transactions";
 export * from "./long/builders";
 export * from "./long/exercise";
 export * from "./long/quotes";
+export {
+  getBuyFromPoolRemainingAccounts,
+} from "./long/remaining-accounts";
 
 export * from "./short/builders";
 export * from "./short/claim-theta";

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/long/remaining-accounts.ts

@@ -0,0 +1,31 @@
+import type { RemainingAccountInput } from "../shared/remaining-accounts";
+import type { AddressLike, KitRpc } from "../client/types";
+import { PROGRAM_ID } from "../client/program";
+import { fetchWriterPositionsForPool } from "../accounts/list";
+
+/**
+ * Returns remaining_accounts for the buy_from_pool instruction: WriterPosition
+ * accounts for the given pool, sorted by unsoldQty ascending (smallest first),
+ * in the shape expected by buildBuyFromPoolTransaction and
+ * buildBuyFromPoolTransactionWithDerivation.
+ */
+export async function getBuyFromPoolRemainingAccounts(
+  rpc: KitRpc,
+  optionPool: AddressLike,
+  programId?: AddressLike
+): Promise<RemainingAccountInput[]> {
+  const positions = await fetchWriterPositionsForPool(
+    rpc,
+    optionPool,
+    programId ?? PROGRAM_ID
+  );
+  const sorted = [...positions].sort((a, b) => {
+    const aQty = a.data.unsoldQty;
+    const bQty = b.data.unsoldQty;
+    return aQty < bQty ? -1 : aQty > bQty ? 1 : 0;
+  });
+  return sorted.map(({ address }) => ({
+    address,
+    isWritable: true,
+  }));
+}

package/package.json

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